Neostrada API {BETA}

Get Your API Token

Please keep in mind that the API is still under heavy development.
Suggestions and/or comments can be sent to Neostrada support team.

Issue View on GitHub Changelog v1.2.1

WHOIS

Whois

REFERENCE

Check if a domain is available. Extension limit is set to 10 per page. Provide the page number for more extensions or provide an extension for lookup.

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

PARAMETER

domain			without http://www. ( Optional .TLD )
page			Optional ( By default page 1 )

Call Resource

Try this call out by providing the access_token and Domain above

Request

POST http://api.neostrada.com

Response

200

BODY

Response
Examples

General

200	API call completed successful
210	Domain name is available
211	Domain name is not available

Error

401	Invalid Token.
403	API rate limit exceeded.
404	Could not complete your request.

HTTP REQUEST

http POST http://api.neostrada.com/api/whois 'Authorization:Bearer {TOKEN}' domain=DOMAIN{.TLD} page=1

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization: Bearer {TOKEN}" --data "domain=DOMAIN{.TLD}&page=1" http://api.neostrada.com/api/whois

Bulk Whois

REFERENCE

Request a bulk whois. TLD's are required.

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

PARAMETER

domain[]

without http(s)://www. ( Required .TLD )

Request

POST http://api.neostrada.com

Response

200

BODY

General

200	API call completed successful
210	Domain name is available
211	Domain name is not available

Error

401	Invalid Token.
402	No TLD found. Bulk Whois requires TLD's.
403	The bulk whois is limited at 20 domains each call.
403	API rate limit exceeded.
404	Could not complete your request.

HTTP REQUEST

http POST http://api.neostrada.com/api/bulkwhois 'Authorization:Bearer {TOKEN}' domain:='["DOMAIN1.TLD", "DOMAIN2.TLD"]' --json

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization: Bearer {TOKEN}" --data '{"domain":["DOMAIN1.TLD","DOMAIN2.TLD"]}' http://api.neostrada.com/api/bulkwhois

Please note while both "Accept" and "Authorization" are required and need to be send as header.

.TLD is also required in a bulk whois call.

Extensions

Get extensions

REFERENCE

Get a list of all extensions currently available.

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

Request

GET http://api.neostrada.com

Response

200

BODY

0: [
- 0: {
  - extension_id: 4
  - extension: "nl"
  - firstyear_price: "1.95"
  - costprice: "4.95"
  }
- 1: {
  - extension_id: 5
  - extension: "com"
  - firstyear_price: "8.99"
  - costprice: "8.99"
  }
]

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.

HTTP REQUEST

http GET http://api.neostrada.com/api/extensions 'Authorization:Bearer {TOKEN}'

cURL REQUEST

curl -i http://api.neostrada.com/api/extensions -H "Authorization: Bearer {TOKEN}"

Please note while both "Accept" and "Authorization" are required and need to be send as header.

Domains

Get domains

REFERENCE

Obtain domains information that are currently active/cancelled by user.

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

Query

filter

string

active or cancelled (Optional)

Request

GET http://api.neostrada.com

Response

200

BODY

0: [
- 0: {
  - id: 1234
  - description: "domein1.nl"
  - extension: ".nl"
  - year: 1
  - discount: "0.00"
  - start_date: "2017-09-13T15:56:06+00:00"
  - paid_until: "2018-09-13T15:56:06+00:00"
  - is_external: 0
  - redirect: ""
  - dns_id: 4321
  - redirect_type: ""
  - status: "active"
  }
- 1: {
  - id: 5678
  - description: "domain2.com"
  - extension: ".com"
  - year: 1
  - discount: "0.00"
  - start_date: "2017-09-13T15:56:06+00:00"
  - paid_until: "2018-09-13T15:56:06+00:00"
  - is_external: 0
  - redirect: ""
  - dns_id: 8765
  - redirect_type: ""
  - status: "cancelled"
  }
]

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.

HTTP REQUEST

http GET http://api.neostrada.com/api/domains 'Authorization:Bearer {TOKEN}'

cURL REQUEST

curl -i http://api.neostrada.com/api/domains -H "Authorization: Bearer {TOKEN}"

Please note while both "Accept" and "Authorization" are required and need to be send as header.

"status" can be active of cancelled. It means that the domain is canceled or it will renew after the paid_until date.

Get single domain

REFERENCE

Obtain domains information that are currently active/cancelled by user.

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

PARAMETER

domain id/name

integer/string

You must send this parameter in order to make a call

Request

GET http://api.neostrada.com

Response

200

BODY

0: {
- id: 1234
- description: "domein1.nl"
- extension: ".nl"
- year: 1
- discount: "0.00"
- start_date: "2017-09-13T15:56:06+00:00"
- paid_until: "2018-09-13T15:56:06+00:00"
- is_external: 0
- redirect: ""
- dns_id: 4321
- redirect_type: ""
- status: "active"
- registrant: {
  - "city: " "Lelystad"
  - "company: " "Neostrada"
  - "country_code: " "NL"
  - "email: " "test@neostrada.nl"
  - "name: " "John Doe"
  - "street: " "Reaalhof 64"
  - "zipcode: " "8232 VS"
  }
- tech: {
  - "city: " "Lelystad"
  - "company: " "Neostrada"
  - "country_code: " "NL"
  - "email: " "test@neostrada.nl"
  - "name: " "John Doe"
  - "street: " "Reaalhof 64"
  - "zipcode: " "8232 VS"
  }
- admin: {
  - "city: " "Lelystad"
  - "company: " "Neostrada"
  - "country_code: " "NL"
  - "email: " "test@neostrada.nl"
  - "name: " "John Doe"
  - "street: " "Reaalhof 64"
  - "zipcode: " "8232 VS"
  }
}

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.

HTTP REQUEST

http GET http://api.neostrada.com/api/domain/domain_id "Accept:application/json" 'Authorization:Bearer {TOKEN}'

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer TOKEN" http://api.neostrada.com/api/domain/domain_id

Please note while both "Accept" and "Authorization" are required and need to be send as header.
For a single domain request you are also required to send the domain_id of the domain.

"status" can be active of cancelled. It means that the domain is canceled or it will continue after the paid_until date.

Edit domain holder

REFERENCE

Add a new holder to domain

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

PARAMETER

registrar	integer	You must send the holder_id to assign holder to domain
admin	integer	You must send the holder_id to assign holder to domain
tech	integer	You must send the holder_id to assign holder to domain

Request

PATCH http://api.neostrada.com

Response

200

BODY

0: {
- id: 1234
- description: "domein1.nl"
- extension: ".nl"
- year: 1
- discount: "0.00"
- start_date: "2017-09-13T15:56:06+00:00"
- paid_until: "2018-09-13T15:56:06+00:00"
- is_external: 0
- redirect: ""
- dns_id: 4321
- redirect_type: ""
- status: "active"
- registrant: {
  - "city: " "Lelystad"
  - "company: " "Neostrada"
  - "country_code: " "NL"
  - "email: " "test@neostrada.nl"
  - "name: " "John Doe"
  - "street: " "Reaalhof 64"
  - "zipcode: " "8232 VS"
  }
- tech: {
  - "city: " "Lelystad"
  - "company: " "Neostrada"
  - "country_code: " "NL"
  - "email: " "test@neostrada.nl"
  - "name: " "John Doe"
  - "street: " "Reaalhof 64"
  - "zipcode: " "8232 VS"
  }
- admin: {
  - "city: " "Lelystad"
  - "company: " "Neostrada"
  - "country_code: " "NL"
  - "email: " "test@neostrada.nl"
  - "name: " "John Doe"
  - "street: " "Reaalhof 64"
  - "zipcode: " "8232 VS"
  }
}

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.

HTTP REQUEST

http POST http://api.neostrada.com/api/domain/edit/123 "Accept:application/json" 'Authorization:Bearer {TOKEN}' registrar=123456 admin=123456 tech=123456

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer TOKEN" --data "registrar=123456&admin=123456&tech=123456" http://api.neostrada.com/api/domain/edit/123

Please note while both "Accept" and "Authorization" are required and need to be send as header.

Delete domain

REFERENCE

Disable automatic renewal for your domain, or delete an external domain.

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

PARAMETER

domain id/name

integer/string

You must send this parameter in order to make a call

Request

DELETE http://api.neostrada.com

Response

200

BODY

0: {
- id: 1234
- domain: "domein1.nl"
- is_external: 1
- status: "cancelled"
}

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.
405	Invalid Method.

HTTP REQUEST

http DELETE http://api.neostrada.com/api/domain/delete/domain_id "Accept:application/json" "Authorization:Bearer TOKEN"

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer TOKEN" -X "DELETE" http://api.neostrada.com/api/domain/delete/domain_id

Please note while both "Accept" and "Authorization" are required and need to be send as header.

You will always get a response with the new status.

DNS

Get DNS records

REFERENCE

This call will response with a list of all DNS records for dns_id

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

PARAMETER

dns_id

string

You must send the dns_id parameter in order to make a call

Query

type

string

Return a specific type (Optional)

Request

GET http://api.neostrada.com

Response

200

BODY

0: [
- 0: {
  - id: 123456
  - domain_id: 1234
  - name: "domein1.nl"
  - type: "A"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
- 2: {
  - id: 789012
  - domain_id: 1234
  - name: "webmail.domein1.nl"
  - type: "A"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 563257
  - domain_id: 1234
  - name: "mail.domein1.nl"
  - type: "A"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 987234
  - domain_id: 1234
  - name: "www.domein1.nl"
  - type: "A"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 9483726
  - domain_id: 1234
  - name: "domein1.nl"
  - type: "NS"
  - content: "sandra.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 1849372
  - domain_id: 1234
  - name: "mail.domein1.nl"
  - type: "NS"
  - content: "christina.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 2594837
  - domain_id: 1234
  - name: "lisa.neostrada.nl"
  - type: "NS"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
]

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.

HTTP REQUEST

http GET http://api.neostrada.com/api/dns/dns_id "Accept:application/json" "Authorization:Bearer TOKEN"

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer TOKEN" http://api.neostrada.com/api/dns/dns_id

Please note while both "Accept" and "Authorization" are required and need to be send as header.

Each record has a unique "id". This id must be used to edit/ delete the dns record.

Add DNS records

REFERENCE

This call will add DNS records to your domain

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

PARAMETER

dns_id

integer

You need to send the dns_id in order to update DNS records

ARGUMENTS

name	string	Required
content	string	Required
type	string	Required
prio	integer	Optional (Default 3600)
ttl	integer	Optional (Default 0)

Request

POST http://api.neostrada.com

Response

200

BODY

0: [
- 0: {
  - id: 123456
  - domain_id: 1234
  - name: "domein1.nl"
  - type: "A"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
- 2: {
  - id: 789012
  - domain_id: 1234
  - name: "webmail.domein1.nl"
  - type: "A"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 563257
  - domain_id: 1234
  - name: "mail.domein1.nl"
  - type: "A"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 987234
  - domain_id: 1234
  - name: "www.domein1.nl"
  - type: "A"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 9483726
  - domain_id: 1234
  - name: "domein1.nl"
  - type: "NS"
  - content: "sandra.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 1849372
  - domain_id: 1234
  - name: "mail.domein1.nl"
  - type: "NS"
  - content: "christina.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 2594837
  - domain_id: 1234
  - name: "lisa.neostrada.nl"
  - type: "NS"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
]

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.
500	Invalid dns record

HTTP REQUEST

http POST http://api.neostrada.com/api/dns/add/dns_id "Accept:application/json" "Authorization:Bearer {TOKEN}" name=example.com content=127.0.0.1 type=A prio=0 ttl=3600

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer {TOKEN}" --data "name=example.com&content=127.0.0.1&type=A&prio=0&ttl=3600" http://api.neostrada.com/api/dns/add/dns_id

Please note while both "Accept" and "Authorization" are required and need to be send as header.

Each record has a unique "record_id". You must use this id to edit/delete one or multiple dns record(s).

Edit DNS records

REFERENCE

This call will update existing DNS records

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

PARAMETER

dns_id

integer

You need to send the dns_id and record_id in order to update the DNS records

ARGUMENTS

record_id	integer	Required
content	string	Optional
prio	integer	Optional
ttl	integer	Optional

Request

PATCH http://api.neostrada.com

Response

200

BODY

0: [
- 0: {
  - id: 123456
  - domain_id: 1234
  - name: "domein1.nl"
  - type: "A"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
- 2: {
  - id: 789012
  - domain_id: 1234
  - name: "webmail.domein1.nl"
  - type: "A"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 563257
  - domain_id: 1234
  - name: "mail.domein1.nl"
  - type: "A"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 987234
  - domain_id: 1234
  - name: "www.domein1.nl"
  - type: "A"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 9483726
  - domain_id: 1234
  - name: "domein1.nl"
  - type: "NS"
  - content: "sandra.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 1849372
  - domain_id: 1234
  - name: "mail.domein1.nl"
  - type: "NS"
  - content: "christina.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 2594837
  - domain_id: 1234
  - name: "lisa.neostrada.nl"
  - type: "NS"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
]

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.
500	Invalid dns record

HTTP REQUEST

http POST http://api.neostrada.com/api/dns/edit/dns_id "Accept:application/json" "Authorization:Bearer {TOKEN}" record_id=123456 content=127.0.0.1 prio=0 ttl=3600

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer {TOKEN}" --data "record_id=123456&content=127.0.0.1&prio=0&ttl=3600" http://api.neostrada.com/api/dns/edit/dns_id

Delete DNS records

REFERENCE

This call will delete existing DNS records

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

PARAMETER

dns_id

integer

You need to send the dns_id in order to update DNS records

ARGUMENTS

record_id

integer

Required

Request

DELETE http://api.neostrada.com

Response

200

BODY

0: [
- 0: {
  - id: 123456
  - domain_id: 1234
  - name: "domein1.nl"
  - type: "A"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
- 2: {
  - id: 789012
  - domain_id: 1234
  - name: "webmail.domein1.nl"
  - type: "A"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 563257
  - domain_id: 1234
  - name: "mail.domein1.nl"
  - type: "A"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 987234
  - domain_id: 1234
  - name: "www.domein1.nl"
  - type: "A"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 9483726
  - domain_id: 1234
  - name: "domein1.nl"
  - type: "NS"
  - content: "sandra.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 1849372
  - domain_id: 1234
  - name: "mail.domein1.nl"
  - type: "NS"
  - content: "christina.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 2594837
  - domain_id: 1234
  - name: "lisa.neostrada.nl"
  - type: "NS"
  - content: "127.0.0.1"
  - ttl: 3600
  - prio: 0
  }
]

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.
500	Invalid dns record

HTTP REQUEST

http POST http://api.neostrada.com/api/dns/delete/dns_id "Accept:application/json" "Authorization:Bearer {TOKEN}" record_id=123456

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer {TOKEN}" --data "record_id=123456" http://api.neostrada.com/api/dns/delete/dns_id

NAMESERVERS

Get nameservers

REFERENCE

This call will response with a list of all nameservers corresponding with the dns_id

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

PARAMETER

dns_id

string

You must send the dns_id parameter in order to make a call

Request

GET http://api.neostrada.com

Response

200

BODY

0: [
- 0: {
  - id: 123456
  - domain_id: 1234
  - name: "example.nl"
  - type: "NS"
  - content: "sandra.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
- 2: {
  - id: 789012
  - domain_id: 1234
  - name: "example.nl"
  - type: "NS"
  - content: "christina.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 563257
  - domain_id: 1234
  - name: "example.nl"
  - type: "NS"
  - content: "lisa.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
]

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.
404	No nameservers corresponding to this dns_id.

HTTP REQUEST

http GET http://api.neostrada.com/api/nameservers/dns_id "Accept:application/json" "Authorization:Bearer TOKEN"

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer TOKEN" http://api.neostrada.com/api/nameservers/dns_id

Please note while both "Accept" and "Authorization" are required and need to be send as header.

Each record has a unique "id". This id must be used to edit/ delete a nameserver.

Add nameservers

REFERENCE

This call will add DNS records to your domain

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

PARAMETER

dns_id

integer

You need to send the dns_id in order to update DNS records

ARGUMENTS

content

string

Required

Request

POST http://api.neostrada.com

Response

200

BODY

0: [
- 0: {
  - id: 123456
  - domain_id: 1234
  - name: "example.nl"
  - type: "NS"
  - content: "sandra.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
- 2: {
  - id: 789012
  - domain_id: 1234
  - name: "example.nl"
  - type: "NS"
  - content: "christina.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 563257
  - domain_id: 1234
  - name: "example.nl"
  - type: "NS"
  - content: "lisa.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
]

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.
500	Invalid nameserver

HTTP REQUEST

http POST http://api.neostrada.com/api/nameservers/add/dns_id "Accept:application/json" "Authorization:Bearer {TOKEN}" content=sandra.neostrada.nl

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer {TOKEN}" --data "content=sandra.neostrada.nl" http://api.neostrada.com/api/nameservers/add/dns_id

Edit nameservers

REFERENCE

This call will update existing nameservers

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

PARAMETER

dns_id

integer

You need to send the dns_id and record_id in order to update the nameserver

ARGUMENTS

record_id	integer	Required
content	string	Required

Request

PATCH http://api.neostrada.com

Response

200

BODY

0: [
- 0: {
  - id: 123456
  - domain_id: 1234
  - name: "example.nl"
  - type: "NS"
  - content: "sandra.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
- 2: {
  - id: 789012
  - domain_id: 1234
  - name: "example.nl"
  - type: "NS"
  - content: "christina.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 563257
  - domain_id: 1234
  - name: "example.nl"
  - type: "NS"
  - content: "lisa.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
]

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.
500	Invalid nameserver

HTTP REQUEST

http POST http://api.neostrada.com/api/nameservers/edit/dns_id "Accept:application/json" "Authorization:Bearer {TOKEN}" record_id=123456 content=sandra.neostrada.nl

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer {TOKEN}" --data "record_id=123456&content=sandra.neostrada.nl" http://api.neostrada.com/api/nameservers/edit/dns_id

Delete nameservers

REFERENCE

This call will delete existing nameservers

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

PARAMETER

dns_id

integer

You need to send the dns_id in order to update DNS records

ARGUMENTS

record_id

integer

Required

Request

DELETE http://api.neostrada.com

Response

200

BODY

0: [
- 0: {
  - id: 123456
  - domain_id: 1234
  - name: "example.nl"
  - type: "NS"
  - content: "sandra.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
- 2: {
  - id: 789012
  - domain_id: 1234
  - name: "example.nl"
  - type: "NS"
  - content: "christina.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 563257
  - domain_id: 1234
  - name: "example.nl"
  - type: "NS"
  - content: "lisa.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
]

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.
500	Invalid dns record

HTTP REQUEST

http POST http://api.neostrada.com/api/nameservers/delete/dns_id "Accept:application/json" "Authorization:Bearer {TOKEN}" record_id=123456

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer {TOKEN}" --data "record_id=123456" http://api.neostrada.com/api/nameservers/delete/dns_id

HOLDERS

Get holders

REFERENCE

This call will response with a list of all holders corresponding with your account

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

Request

GET http://api.neostrada.com

Response

200

BODY

0: [
- 0: {
  - holder_id: 123456
  - client_id: 1234
  - company: "Neostrada B.V."
  - firstname: "John"
  - center: ""
  - lastname: "Doe"
  - phone_code: "+31"
  - phone_number: 0612345678
  - street: "Lelystraat"
  - house_number: 10
  - house_number_pf: ""
  - zipcode: "8213 AB"
  - city: "Lelystad"
  - country_id: 1
  - email: "john_doe@example.nl"
  }
- 0: {
  - holder_id: 123457
  - client_id: 1234
  - company: ""
  - firstname: "Dave"
  - center: ""
  - lastname: "de With"
  - phone_code: "+31"
  - phone_number: 0687654321
  - street: "Amsterdamlaan"
  - house_number: 1
  - house_number_pf: "4B"
  - zipcode: "1234 AB"
  - city: "Amsterdam"
  - country_id: 1
  - email: "dave_dewith@example.nl"
  }
]

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.
404	No holders found.

HTTP REQUEST

http GET http://api.neostrada.com/api/holders "Accept:application/json" "Authorization:Bearer TOKEN"

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer TOKEN" http://api.neostrada.com/api/holders

Please note while both "Accept" and "Authorization" are required and need to be send as header.

Add holders

REFERENCE

This call will add holders to your account

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

ARGUMENTS

company	string	Optional
firstname	string	Required
center	string	Optional
lastname	string	Required
phone_number	integer	Required without country code (limited at 12 numbers)
street	string	Required
house_number	string	Required
house_number_pf	string	Optional
zipcode	string	Required
city	string	Required
country_id	integer	Required see country for id's
email	string	Required

Request

POST http://api.neostrada.com

Response

200

BODY

0: [
- 0: {
  - holder_id: 123456
  - client_id: 1234
  - company: "Neostrada B.V."
  - firstname: "John"
  - center: ""
  - lastname: "Doe"
  - phone_code: "+31"
  - phone_number: 0612345678
  - street: "Lelystraat"
  - house_number: 10
  - house_number_pf: ""
  - zipcode: "8213 AB"
  - city: "Lelystad"
  - country_id: 1
  - email: "john_doe@example.nl"
  }
- 0: {
  - holder_id: 123457
  - client_id: 1234
  - company: ""
  - firstname: "Dave"
  - center: ""
  - lastname: "de With"
  - phone_code: "+31"
  - phone_number: 0687654321
  - street: "Amsterdamlaan"
  - house_number: 1
  - house_number_pf: "4B"
  - zipcode: "1234 AB"
  - city: "Amsterdam"
  - country_id: 1
  - email: "dave_dewith@example.nl"
  }
]

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.
500	Invalid nameserver

HTTP REQUEST

http POST http://api.neostrada.com/api/holders/add "Accept:application/json" "Authorization:Bearer {TOKEN}" firstname=John lastname=Doe phone_number=0612345678 street=Lelystraat house_number=10 zipcode=8213AB city=Lelystad country_id=1 email=john_doe@example.com

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer {TOKEN}" --data "firstname=John&lastname=Doe&phone_number=0612345678&street=Lelystraat&house_number=10&zipcode=8213AB&city=Lelystad&country_id=1&email=john_doe@example.com" http://api.neostrada.com/api/holders/add

Please note while both "Accept" and "Authorization" are required and need to be send as header.

Edit holders

REFERENCE

This call will update existing holders

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

PARAMETER

holder_id

integer

You need to send the holder_id in order to update a holder

ARGUMENTS

company	string	Optional
firstname	string	Optional
center	string	Optional
lastname	string	Optional
phone_number	integer	Optional without country code (limited at 12 numbers)
street	string	Optional
house_number	string	Optional
house_number_pf	string	Optional
zipcode	string	Optional
city	string	Optional
country_id	integer	Optional see country for id's
email	string	Optional

Request

PATCH http://api.neostrada.com

Response

200

BODY

0: [
- 0: {
  - holder_id: 123456
  - client_id: 1234
  - company: "Neostrada B.V."
  - firstname: "John"
  - center: ""
  - lastname: "Doe"
  - phone_code: "+31"
  - phone_number: 0612345678
  - street: "Lelystraat"
  - house_number: 10
  - house_number_pf: ""
  - zipcode: "8213 AB"
  - city: "Lelystad"
  - country_id: 1
  - email: "john_doe@example.nl"
  }
- 0: {
  - holder_id: 123457
  - client_id: 1234
  - company: ""
  - firstname: "Dave"
  - center: ""
  - lastname: "de With"
  - phone_code: "+31"
  - phone_number: 0687654321
  - street: "Amsterdamlaan"
  - house_number: 1
  - house_number_pf: "4B"
  - zipcode: "1234 AB"
  - city: "Amsterdam"
  - country_id: 1
  - email: "dave_dewith@example.nl"
  }
]

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.
500	Invalid nameserver

HTTP REQUEST

http POST http://api.neostrada.com/api/holders/edit/holder_id "Accept:application/json" "Authorization:Bearer {TOKEN}" record_id=123456 content=sandra.neostrada.nl

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer {TOKEN}" --data "record_id=123456&content=sandra.neostrada.nl" http://api.neostrada.com/api/holders/edit/holder_id

Delete holders

REFERENCE

This call will delete existing holders

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

ARGUMENTS

holder_id

integer

Required

Request

DELETE http://api.neostrada.com

Response

200

BODY

0: [
- 0: {
  - holder_id: 123456
  - client_id: 1234
  - company: "Neostrada B.V."
  - firstname: "John"
  - center: ""
  - lastname: "Doe"
  - phone_code: "+31"
  - phone_number: 0612345678
  - street: "Lelystraat"
  - house_number: 10
  - house_number_pf: ""
  - zipcode: "8213 AB"
  - city: "Lelystad"
  - country_id: 1
  - email: "john_doe@example.nl"
  }
- 0: {
  - holder_id: 123457
  - client_id: 1234
  - company: ""
  - firstname: "Dave"
  - center: ""
  - lastname: "de With"
  - phone_code: "+31"
  - phone_number: 0687654321
  - street: "Amsterdamlaan"
  - house_number: 1
  - house_number_pf: "4B"
  - zipcode: "1234 AB"
  - city: "Amsterdam"
  - country_id: 1
  - email: "dave_dewith@example.nl"
  }
]

General

200	API call completed successful

Error

400	Bad request.
401	Invalid Token.
403	API rate limit exceeded.

HTTP REQUEST

http POST http://api.neostrada.com/api/holders/delete/ "Accept:application/json" "Authorization:Bearer {TOKEN}" holder_id=123456

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer {TOKEN}" --data "holder_id=123456" http://api.neostrada.com/api/holders/delete/

Please note while both "Accept" and "Authorization" are required and need to be send as header.

COUNTRY

Get countries

REFERENCE

This call will response with a list of all countries

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

Request

GET http://api.neostrada.com

Response

200

BODY

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.
404	No countries found.

HTTP REQUEST

http GET http://api.neostrada.com/api/countries/ "Accept:application/json" "Authorization:Bearer TOKEN"

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer TOKEN" http://api.neostrada.com/api/countries/

Please note while both "Accept" and "Authorization" are required and need to be send as header.

Orders

Get planned orders

REFERENCE

This call will response with a list of all planned orders

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

Request

GET http://api.neostrada.com

Response

200

BODY

0: [
- 0: {
  - id: 123456
  - domain_id: 1234
  - name: "example.nl"
  - type: "NS"
  - content: "sandra.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
- 2: {
  - id: 789012
  - domain_id: 1234
  - name: "example.nl"
  - type: "NS"
  - content: "christina.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
- 3: {
  - id: 563257
  - domain_id: 1234
  - name: "example.nl"
  - type: "NS"
  - content: "lisa.neostrada.nl"
  - ttl: 3600
  - prio: 0
  }
]

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.

HTTP REQUEST

http GET http://api.neostrada.com/api/nameservers/dns_id "Accept:application/json" "Authorization:Bearer TOKEN"

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer TOKEN" http://api.neostrada.com/api/nameservers/dns_id

Please note while both "Accept" and "Authorization" are required and need to be send as header.

Each record has a unique "id". This id must be used to edit/ delete a nameserver.

Add order

REFERENCE

This call will register or transfer a new domain name

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

PARAMETER

extension_id	integer	Required
domain	string	Required
authcode	string	Optional
holder_id	integer	Optional
year	integer	Optional (1,2 or 3 years)
nameservers	array	Optional custom nameservers

Request

POST http://api.neostrada.com

Response

200

BODY

0: {
- code: 200
- message: "Order placed"
}

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.

HTTP REQUEST

http POST http://api.neostrada.com/api/orders/add/ "Accept:application/json" "Authorization:Bearer {TOKEN}" extension_id=4 domain=example.nl year=1

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer {TOKEN}" --data "extension_id=4&domain=example.nl&year=1" http://api.neostrada.com/api/orders/add/

Please note while both "Accept" and "Authorization" are required and need to be send as header.

The extension_id can be found after calling the whois or bulkwhois. When an auth code is sent, your order will be automatically processed as an transfer.

Add order (external)

REFERENCE

This call will add a external domain name

HEADERS

Content-Type		string	You must send the Content Type as header.
access_token		string	Authentication.

PARAMETER

extension_id	integer	Required
domain	string	Required
external_ip	string	Optional

Request

POST http://api.neostrada.com

Response

200

BODY

0: {
- code: 200
- message: "Order placed"
}

General

200	API call completed successful

Error

401	Invalid Token.
403	API rate limit exceeded.

HTTP REQUEST

http POST http://api.neostrada.com/api/orders/external/add/ "Accept:application/json" "Authorization:Bearer {TOKEN}" extension_id=4 domain=example.nl external_ip=127.0.0.1 holder_id=1234

cURL REQUEST

curl -i -H "Accept:application/json" -H "Authorization:Bearer {TOKEN}" --data "extension_id=4&domain=example.nl&external_ip=127.0.0.1&holder_id=1234" http://api.neostrada.com/api/orders/external/add/

Please note while both "Accept" and "Authorization" are required and need to be send as header.

The extension_id can be found after calling the whois, bulkwhois or get extensions.