API

1. Basic information

API requests are made at the following address:
https://quix.email/api/v1/<API_KEY>/<METHOD>

Where:
API_KEY - API access key, which you can get on the Profile page.
METHOD - API method name. The list of available methods is presented below.

The response content will be in JSON format with the following fields:

Name	Type	Description
success	bool	Whether the request was successful. If false, the error field will be present, but the result will be absent, and vice versa.
error	string	Error text.
result	mixed	Response Contents (response fields).

You can restrict access to the API with your key by IP. To do this, go to Profile, specify from which IP addresses access will be allowed, enter the password for the account and click the "Change allowed IP addresses" button.

2. Get account balance

GET

http://quix.email/api/v1/<API_KEY>/accountBalance

Response fields

Name	Type	Description
balance	float	Your account balance in USD.

3. Get domains list. Returns an array

GET

http://quix.email/api/v1/<API_KEY>/emailDomains

Request parameters

Name	Type	Required	Description
info	bool	false	Whether to also return information about the number and cost of mail. If true, each element of the returned array will contain the response fields described below. Otherwise (false) - each element of the returned array will contain only a string with the domain. Default - true.
site	string	false	Show available quantity for this site only. Also need to pass info=true.

Response fields

Name	Type	Description
domain	string	Email domain.
quantity	int	Available quantity.
price	float	Cost of one mail.

4. Activation. Order

GET

http://quix.email/api/v1/<API_KEY>/emailGet

Request parameters

Name	Type	Required	Description
site	string	true	The domain of the site from which the email will be sent.
domain	string	true	Email domain or a group. You can specify multiple values by separating them with a comma, for example: gmx.com,gmail.com,quixemail

Response fields

Name	Type	Description
id	string	Activation ID.
email	string	Email you can use.
site	string	The domain from which the email will be expected.

5. Activation. Get status and email content (if any)

GET

http://quix.email/api/v1/<API_KEY>/emailStatus

Request parameters

Name	Type	Required	Description
id	string	true	Activation ID.

Response fields

Name	Type	Description
id	string	Activation ID.
email	string	Email you can use.
status	string	Activation status, one of: - completed - cancelled - no_email.
data	string	Contents of the email. Available with completed status.
parsed	string	Parsed activation code or link.

6. Activation. Code

GET

http://quix.email/api/v1/<API_KEY>/emailCode

Request parameters

Name	Type	Required	Description
id	string	true	Activation ID.

Response fields

Name	Type	Description
code	string	Activation code or link that was parsed from the letter.

7. Activation. Complete

GET

http://quix.email/api/v1/<API_KEY>/emailComplete

Request parameters

Name	Type	Required	Description
id	string	true	Activation ID.

Response fields

Name	Type	Description
completed	bool	Whether the activation successfully completed.

8. Activation. Cancel

GET

http://quix.email/api/v1/<API_KEY>/emailCancel

Request parameters

Name	Type	Required	Description
id	string	true	Activation ID.

Response fields

Name	Type	Description
cancelled	bool	Whether the cancellation performed.

9. Activation. Repeat

GET

http://quix.email/api/v1/<API_KEY>/emailRepeat

Request parameters

Name	Type	Required	Description
id	string	true	Activation ID, email and domain which must be reused.

Response fields

Name	Type	Description
id	string	New activation ID.
email	string	Email you can use.
site	string	The domain from which the email will be expected.

10. Activation. Find IDs

GET

http://quix.email/api/v1/<API_KEY>/emailFindIds

Request parameters

Name	Type	Required	Description
email	string	true	Email that will be searched for activations.

Response fields

Name	Type	Description
ids	array	Array with IDs of activations in which the specified email was used. The array elements are sorted in order of use, with the earliest activations first.

11. Multisite. Order

GET

http://quix.email/api/v1/<API_KEY>/multisiteOrder

Request parameters

Name	Type	Required	Description
domain	string	true	Email domain.
sites	string	true	List of sites for which the mail will be used, separated by commas.
period	int	true	Rental period from 1 to 24 hours.

Response fields

Name	Type	Description
id	string	Order ID.
email	string	Email for use.
expire	int	Number of seconds before rent expires.

12. Multisite. Get information

GET

http://quix.email/api/v1/<API_KEY>/multisiteInfo

Request parameters

Name	Type	Required	Description
id	string	true	Order ID.

Response fields

Name	Type	Description
id	string	Order ID.
email	string	Email for use.
expire	int	Number of seconds before rent expires. It may be negative.
expired	bool	Whether the rental period ended.

13. Multisite. Receive letters. Returns array

GET

http://quix.email/api/v1/<API_KEY>/multisiteLetters

Request parameters

Name	Type	Required	Description
id	string	true	Order ID.

Response fields

Name	Type	Description
from	string	Sender's email.
subject	string	Subject of the letter.
data	string	Contents of the letter.

14. Multisite. Repeat

GET

http://quix.email/api/v1/<API_KEY>/multisiteReorder

Request parameters

Name	Type	Required	Description
id	string	true	Order ID.
period	int	true	Rental period from 1 to 24 hours.

Response fields

Name	Type	Description
id	string	New order ID.
email	string	Email for use.
expire	int	Number of seconds before rent expires.

15. Multisite. Extend

GET

http://quix.email/api/v1/<API_KEY>/multisiteExtend

Request parameters

Name	Type	Required	Description
id	string	true	Order ID.
period	int	true	Rental extension period from 1 to 24 hours.

Response fields

Name	Type	Description
	bool	Whether the rent extended.