SMSPVAdevelopers
Private Email Rental
SMSPVA / DOCUMENTATION

Errors & response codes

SMSPVA API

Check the result

HTTP 200 alone does not confirm success. Read status: 1 means success, 0 means an error, and 2 means no mailbox was available during creation. The parsed-language examples check HTTP and status; cURL prints the JSON for you to check.

Error details may be in msg, errormsg or errorid. Some errors contain only msg, so do not wait for a numeric code before treating status=0 as a failure.

Error codes

erroridMeaning
2Unknown or unavailable service
7Invalid request parameters
9Unknown or disabled provider
10Active-order limit reached
16Order creation requests are too frequent

For errorid=9, refresh Providers. For status=2 when creating a rental, refresh Mailbox counts.

Messages you may receive

Incorrect apikey means the key is missing or malformed; Unknown apikey means no account was found. User is not owner of order means you need the order owner’s key. A balance error can be Balance is not enough or Balance is lower than zero (a non-positive balance).

Other messages are listed below. Keep the original message, status and any other error fields when reporting a problem.

  • Order not found
  • Aliases are only available for Gmail
  • Incorrect service code
  • Incorrect duration type
  • Incorrect duration count
  • Incorrect order id
  • Incorrect email id
  • Email service temporarily unavailable
  • Incorrect method

On this page