EzineArticles API

EzineArticles API - Member Account Status

Your application may need to retrieve a status of existing EzineArticles member, for example membership level, number of submissions left or a list of alternate author names. This might be helpful if you are developing an application which submits articles on behalf of your customers who are also members of EzineArticles.

« Return to API home

Parameters for retrieving Account Status

Note: This method requires Member Authentication.

ParameterPossible ValuesPurposeDefault
searchaccount.statusTo indicate a request for account status information.Required
emailThe email address for an EzineArticles Membership Account (Used to login to Membership Account).Required
passEzineArticles member's password associated with the email.Required

Account Status Request Example

http://api.ezinearticles.com/api.php?search=account.status&response_format=xml&email={email address}&pass={password}&key={your api key}

The above API request will return something similar to this:

<ezinearticles_api_response>
<membership_level>Platinum</membership_level>
<submissions_left>Unlimited</submissions_left>
<account_author>Christopher Knight</account_author>
<alternate>
<author>Chris Knight</author>
<author>C. Knight</author>
</alternate>
<response_info>
<time>2008-08-27 16:36:49</time>
<status>200</status>
<search>account.status</search>
<format>xml</format>
</response_info>
</ezinearticles_api_response>

Explanation of Account Status Returned Values

ValueRepresents
membership_levelIndicates level of membership. In case this account is suspended, this value will be set to 'Suspended' which means article submissions are not accepted from this account.
submissions_leftNumber of allowed article submissions. This value might be an Integer representing number of submissions left or if the account is eligible for unlimited submissions this will be set to 'Unlimited'.
account_authorThe accounts' primary author name.
alternateContains available alternate author names under this account.

Response Status Codes

If there is a problem with your API request, an error message will be shown in the format specified by the response_format parameter or in plain text if that parameter is missing.

CodeMeaning
200The request was successful. This code will accompany a response from the API.
404No results found. This code will accompany a message explaining that no results were found for your request.
400The request was invalid. This code will also be sent if you have exceeded your maximum hourly requests or your API Key is invalid.
500The API is experiencing a problem unrelated to your request that prevents it being performed at this time.