Register New User Account POST
Creates a new user account for access to myLEAF and other LEAF services. Account details, including username and password are sent to the email address provided.
Request Parameters
| Parameter | Name | Type | Description |
| title | Title | Enumeration | |
| forename | Forename | String (Optional) | |
| surname | Surname | String | |
| email | EMail Address | String | Do not include any space or punctuation
|
| position | Position | String (Optional) | |
| address | Address | String (Optional) | |
| county | County | String (Optional) | |
| postcode | Postcode | String (Optional) | |
| country | Country | Enumeration | |
| phone | Phone | String (Optional) | |
| fax | Fax | String (Optional) | |
| mobile | Mobile | String (Optional) | |
| ebriefsubscribe | Subscribe to eBrief | Boolean (Optional) | Set to true to subscribe the user to the LEAF eBrief |
Response Parameters
| Parameter | Name | Type | Description |
| action | Action | Enumeration | |
Title (Request)
| Value | Description |
| Mr |
| Mrs |
| Miss |
| Ms |
| Dr |
| Prof |
| Rev |
| Lord |
| Lady |
| Sir |
| Rt. Hon |
| Dame |
Country (Request)
| Value | Description |
| Please select |
| United Kingdom |
| Jersey |
| Guernsey |
| United States of America |
| Afghanistan |
| Albania |
| Algeria |
| American Samoa |
| Andorra |
| Angola |
| Anguilla |
| Antarctica |
| Antigua & Barbuda |
| Argentina |
| Armenia |
| Aruba |
| Australia |
| Austria |
| Azerbaijan |
| Bahamas |
| Bahrain |
| Bangladesh |
| Barbados |
| Belarus |
| Belgium |
| Belize |
| Benin |
| Bermuda |
| Bhutan |
| Bolivia |
| Bosnia and Herzegovina |
| Botswana |
| Bouvet Island |
| Brazil |
| British Indian Ocean Territory |
| British Virgin Islands |
| Brunei Darussalam |
| Bulgaria |
| Burkina Faso |
| Burundi |
| Cambodia |
| Cameroon |
| Canada |
| Cape Verde |
| Cayman Islands |
| Central African Republic |
| Chad |
| Chile |
| China |
| Christmas Island |
| Cocos (Keeling) Islands |
| Colombia |
| Comoros |
| Congo |
| Cook Islands |
| Costa Rica |
| Côte d'Ivoire |
| Croatia |
| Cuba |
| Cyprus |
| Czech Republic |
| Demo. People's Rep. of Korea |
| Democratic Rep. of Congo |
| Denmark |
| Djibouti |
| Dominica |
| Dominican Republic |
| East Timor (Timor-Leste) |
| Ecuador |
| Egypt |
| El Salvador |
| Equatorial Guinea |
| Eritrea |
| Estonia |
| Ethiopia |
| Falkland Islands (Malvinas) |
| Faroe Islands |
| Federated States of Micronesia |
| Fiji |
| Finland |
| France |
| French Guiana |
| French Polynesia |
| French Southern Territories |
| Gabon |
| Gambia |
| Georgia |
| Germany |
| Ghana |
| Gibraltar |
| Greece |
| Greenland |
| Grenada |
| Guadeloupe |
| Guam |
| Guatemala |
| Guinea |
| Guinea-Bissau |
| Guyana |
| Haiti |
| Heard and McDonald Islands |
| Holy See (Vatican City State) |
| Honduras |
| Hong Kong |
| Hungary |
| Iceland |
| India |
| Indonesia |
| Iran |
| Iraq |
| Ireland |
| Isle of Man |
| Israel |
| Italy |
| Jamaica |
| Japan |
| Jordan |
| Kazakhstan |
| Kenya |
| Kiribati |
| Kuwait |
| Kyrgyzstan |
| Lao People's Democratic Republic |
| Latvia |
| Lebanon |
| Lesotho |
| Liberia |
| Libyan Arab Jamahiriya |
| Liechtenstein |
| Lithuania |
| Luxembourg |
| Macao |
| Macedonia |
| Madagascar |
| Malawi |
| Malaysia |
| Maldives |
| Mali |
| Malta |
| Marshall Islands |
| Martinique |
| Mauritania |
| Mauritius |
| Mayotte |
| Mexico |
| Monaco |
| Mongolia |
| Montenegro |
| Montserrat |
| Morocco |
| Mozambique |
| Myanmar (ex-Burma) |
| Namibia |
| Nauru |
| Nepal |
| Netherlands |
| Netherlands Antilles |
| New Caledonia |
| New Zealand |
| Nicaragua |
| Niger |
| Nigeria |
| Niue |
| Norfolk Island |
| Northern Mariana Islands |
| Norway |
| Oman |
| Pakistan |
| Palau |
| Palestinian Territory |
| Panama |
| Papua New Guinea |
| Paraguay |
| Peru |
| Philippines |
| Pitcairn Island |
| Poland |
| Portugal |
| Puerto Rico |
| Qatar |
| Republic of Moldova |
| Republic of South Korea |
| Reunion |
| Romania |
| Russia (Russian Federation) |
| Rwanda |
| S. Georgia and S. Sandwich Is. |
| Sahara |
| Saint Helena |
| Saint Kitts and Nevis |
| Saint Lucia |
| Saint Pierre and Miquelon |
| Saint Vincent and the Grenadines |
| Samoa |
| San Marino |
| Sao Tome and Principe |
| Saudi Arabia |
| Senegal |
| Serbia |
| Seychelles |
| Sierra Leone |
| Singapore |
| Slovakia |
| Slovenia |
| Solomon Islands |
| Somalia |
| South Africa |
| Spain |
| Sri Lanka (ex-Ceilan) |
| Sudan |
| Suriname |
| Svalbard and Jan Mayen Islands |
| Swaziland |
| Sweden |
| Switzerland |
| Syrian Arab Republic |
| Taiwan |
| Tajikistan |
| Tanzania |
| Thailand |
| Timor-Leste (East Timor) |
| Togo |
| Tokelau |
| Tonga |
| Trinidad & Tobago |
| Tunisia |
| Turkey |
| Turkmenistan |
| Turks and Caicos Islands |
| Tuvalu |
| U.S.Virgin Islands |
| Uganda |
| Ukraine |
| United Arab Emirates |
| United Republic of Tanzania |
| Uruguay |
| US Minor Outlying Islands |
| Uzbekistan |
| Vanuatu |
| Venezuela |
| Viet Nam |
| Wallis and Futuna |
| Western Sahara |
| Yemen |
| Zambia |
| Zimbabwe |
Action (Response)
| Value | Description |
| The user was registered successfully |
| An account already exists for the given email address |
| Email could not be sent |
Request Schema
<?xml version="1.0" encoding="utf-8"?>
<xsd:schema elementFormDefault="qualified" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<xsd:element name="registration">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="title">
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Mr" />
<xsd:enumeration value="Mrs" />
<xsd:enumeration value="Miss" />
<xsd:enumeration value="Ms" />
<xsd:enumeration value="Dr" />
<xsd:enumeration value="Prof" />
<xsd:enumeration value="Rev" />
<xsd:enumeration value="Lord" />
<xsd:enumeration value="Lady" />
<xsd:enumeration value="Sir" />
<xsd:enumeration value="Rt. Hon" />
<xsd:enumeration value="Dame" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="forename" minOccurs="0" type="xsd:string" />
<xsd:element name="surname" type="xsd:string" />
<xsd:element name="email" type="xsd:string">
<xsd:annotation>
<xsd:documentation>Do not include any space or punctuation
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="position" minOccurs="0" type="xsd:string" />
<xsd:element name="address" minOccurs="0" type="xsd:string" />
<xsd:element name="county" minOccurs="0" type="xsd:string" />
<xsd:element name="postcode" minOccurs="0" type="xsd:string" />
<xsd:element name="country">
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Please select" />
<xsd:enumeration value="United Kingdom" />
<xsd:enumeration value="Jersey" />
<xsd:enumeration value="Guernsey" />
<xsd:enumeration value="United States of America" />
<xsd:enumeration value="Afghanistan" />
<xsd:enumeration value="Albania" />
<xsd:enumeration value="Algeria" />
<xsd:enumeration value="American Samoa" />
<xsd:enumeration value="Andorra" />
<xsd:enumeration value="Angola" />
<xsd:enumeration value="Anguilla" />
<xsd:enumeration value="Antarctica" />
<xsd:enumeration value="Antigua & Barbuda" />
<xsd:enumeration value="Argentina" />
<xsd:enumeration value="Armenia" />
<xsd:enumeration value="Aruba" />
<xsd:enumeration value="Australia" />
<xsd:enumeration value="Austria" />
<xsd:enumeration value="Azerbaijan" />
<xsd:enumeration value="Bahamas" />
<xsd:enumeration value="Bahrain" />
<xsd:enumeration value="Bangladesh" />
<xsd:enumeration value="Barbados" />
<xsd:enumeration value="Belarus" />
<xsd:enumeration value="Belgium" />
<xsd:enumeration value="Belize" />
<xsd:enumeration value="Benin" />
<xsd:enumeration value="Bermuda" />
<xsd:enumeration value="Bhutan" />
<xsd:enumeration value="Bolivia" />
<xsd:enumeration value="Bosnia and Herzegovina" />
<xsd:enumeration value="Botswana" />
<xsd:enumeration value="Bouvet Island" />
<xsd:enumeration value="Brazil" />
<xsd:enumeration value="British Indian Ocean Territory" />
<xsd:enumeration value="British Virgin Islands" />
<xsd:enumeration value="Brunei Darussalam" />
<xsd:enumeration value="Bulgaria" />
<xsd:enumeration value="Burkina Faso" />
<xsd:enumeration value="Burundi" />
<xsd:enumeration value="Cambodia" />
<xsd:enumeration value="Cameroon" />
<xsd:enumeration value="Canada" />
<xsd:enumeration value="Cape Verde" />
<xsd:enumeration value="Cayman Islands" />
<xsd:enumeration value="Central African Republic" />
<xsd:enumeration value="Chad" />
<xsd:enumeration value="Chile" />
<xsd:enumeration value="China" />
<xsd:enumeration value="Christmas Island" />
<xsd:enumeration value="Cocos (Keeling) Islands" />
<xsd:enumeration value="Colombia" />
<xsd:enumeration value="Comoros" />
<xsd:enumeration value="Congo" />
<xsd:enumeration value="Cook Islands" />
<xsd:enumeration value="Costa Rica" />
<xsd:enumeration value="Côte d'Ivoire" />
<xsd:enumeration value="Croatia" />
<xsd:enumeration value="Cuba" />
<xsd:enumeration value="Cyprus" />
<xsd:enumeration value="Czech Republic" />
<xsd:enumeration value="Demo. People's Rep. of Korea" />
<xsd:enumeration value="Democratic Rep. of Congo" />
<xsd:enumeration value="Denmark" />
<xsd:enumeration value="Djibouti" />
<xsd:enumeration value="Dominica" />
<xsd:enumeration value="Dominican Republic" />
<xsd:enumeration value="East Timor (Timor-Leste)" />
<xsd:enumeration value="Ecuador" />
<xsd:enumeration value="Egypt" />
<xsd:enumeration value="El Salvador" />
<xsd:enumeration value="Equatorial Guinea" />
<xsd:enumeration value="Eritrea" />
<xsd:enumeration value="Estonia" />
<xsd:enumeration value="Ethiopia" />
<xsd:enumeration value="Falkland Islands (Malvinas)" />
<xsd:enumeration value="Faroe Islands" />
<xsd:enumeration value="Federated States of Micronesia" />
<xsd:enumeration value="Fiji" />
<xsd:enumeration value="Finland" />
<xsd:enumeration value="France" />
<xsd:enumeration value="French Guiana" />
<xsd:enumeration value="French Polynesia" />
<xsd:enumeration value="French Southern Territories" />
<xsd:enumeration value="Gabon" />
<xsd:enumeration value="Gambia" />
<xsd:enumeration value="Georgia" />
<xsd:enumeration value="Germany" />
<xsd:enumeration value="Ghana" />
<xsd:enumeration value="Gibraltar" />
<xsd:enumeration value="Greece" />
<xsd:enumeration value="Greenland" />
<xsd:enumeration value="Grenada" />
<xsd:enumeration value="Guadeloupe" />
<xsd:enumeration value="Guam" />
<xsd:enumeration value="Guatemala" />
<xsd:enumeration value="Guinea" />
<xsd:enumeration value="Guinea-Bissau" />
<xsd:enumeration value="Guyana" />
<xsd:enumeration value="Haiti" />
<xsd:enumeration value="Heard and McDonald Islands" />
<xsd:enumeration value="Holy See (Vatican City State)" />
<xsd:enumeration value="Honduras" />
<xsd:enumeration value="Hong Kong" />
<xsd:enumeration value="Hungary" />
<xsd:enumeration value="Iceland" />
<xsd:enumeration value="India" />
<xsd:enumeration value="Indonesia" />
<xsd:enumeration value="Iran" />
<xsd:enumeration value="Iraq" />
<xsd:enumeration value="Ireland" />
<xsd:enumeration value="Isle of Man" />
<xsd:enumeration value="Israel" />
<xsd:enumeration value="Italy" />
<xsd:enumeration value="Jamaica" />
<xsd:enumeration value="Japan" />
<xsd:enumeration value="Jordan" />
<xsd:enumeration value="Kazakhstan" />
<xsd:enumeration value="Kenya" />
<xsd:enumeration value="Kiribati" />
<xsd:enumeration value="Kuwait" />
<xsd:enumeration value="Kyrgyzstan" />
<xsd:enumeration value="Lao People's Democratic Republic" />
<xsd:enumeration value="Latvia" />
<xsd:enumeration value="Lebanon" />
<xsd:enumeration value="Lesotho" />
<xsd:enumeration value="Liberia" />
<xsd:enumeration value="Libyan Arab Jamahiriya" />
<xsd:enumeration value="Liechtenstein" />
<xsd:enumeration value="Lithuania" />
<xsd:enumeration value="Luxembourg" />
<xsd:enumeration value="Macao" />
<xsd:enumeration value="Macedonia" />
<xsd:enumeration value="Madagascar" />
<xsd:enumeration value="Malawi" />
<xsd:enumeration value="Malaysia" />
<xsd:enumeration value="Maldives" />
<xsd:enumeration value="Mali" />
<xsd:enumeration value="Malta" />
<xsd:enumeration value="Marshall Islands" />
<xsd:enumeration value="Martinique" />
<xsd:enumeration value="Mauritania" />
<xsd:enumeration value="Mauritius" />
<xsd:enumeration value="Mayotte" />
<xsd:enumeration value="Mexico" />
<xsd:enumeration value="Monaco" />
<xsd:enumeration value="Mongolia" />
<xsd:enumeration value="Montenegro" />
<xsd:enumeration value="Montserrat" />
<xsd:enumeration value="Morocco" />
<xsd:enumeration value="Mozambique" />
<xsd:enumeration value="Myanmar (ex-Burma)" />
<xsd:enumeration value="Namibia" />
<xsd:enumeration value="Nauru" />
<xsd:enumeration value="Nepal" />
<xsd:enumeration value="Netherlands" />
<xsd:enumeration value="Netherlands Antilles" />
<xsd:enumeration value="New Caledonia" />
<xsd:enumeration value="New Zealand" />
<xsd:enumeration value="Nicaragua" />
<xsd:enumeration value="Niger" />
<xsd:enumeration value="Nigeria" />
<xsd:enumeration value="Niue" />
<xsd:enumeration value="Norfolk Island" />
<xsd:enumeration value="Northern Mariana Islands" />
<xsd:enumeration value="Norway" />
<xsd:enumeration value="Oman" />
<xsd:enumeration value="Pakistan" />
<xsd:enumeration value="Palau" />
<xsd:enumeration value="Palestinian Territory" />
<xsd:enumeration value="Panama" />
<xsd:enumeration value="Papua New Guinea" />
<xsd:enumeration value="Paraguay" />
<xsd:enumeration value="Peru" />
<xsd:enumeration value="Philippines" />
<xsd:enumeration value="Pitcairn Island" />
<xsd:enumeration value="Poland" />
<xsd:enumeration value="Portugal" />
<xsd:enumeration value="Puerto Rico" />
<xsd:enumeration value="Qatar" />
<xsd:enumeration value="Republic of Moldova" />
<xsd:enumeration value="Republic of South Korea" />
<xsd:enumeration value="Reunion" />
<xsd:enumeration value="Romania" />
<xsd:enumeration value="Russia (Russian Federation)" />
<xsd:enumeration value="Rwanda" />
<xsd:enumeration value="S. Georgia and S. Sandwich Is." />
<xsd:enumeration value="Sahara" />
<xsd:enumeration value="Saint Helena" />
<xsd:enumeration value="Saint Kitts and Nevis" />
<xsd:enumeration value="Saint Lucia" />
<xsd:enumeration value="Saint Pierre and Miquelon" />
<xsd:enumeration value="Saint Vincent and the Grenadines" />
<xsd:enumeration value="Samoa" />
<xsd:enumeration value="San Marino" />
<xsd:enumeration value="Sao Tome and Principe" />
<xsd:enumeration value="Saudi Arabia" />
<xsd:enumeration value="Senegal" />
<xsd:enumeration value="Serbia" />
<xsd:enumeration value="Seychelles" />
<xsd:enumeration value="Sierra Leone" />
<xsd:enumeration value="Singapore" />
<xsd:enumeration value="Slovakia" />
<xsd:enumeration value="Slovenia" />
<xsd:enumeration value="Solomon Islands" />
<xsd:enumeration value="Somalia" />
<xsd:enumeration value="South Africa" />
<xsd:enumeration value="Spain" />
<xsd:enumeration value="Sri Lanka (ex-Ceilan)" />
<xsd:enumeration value="Sudan" />
<xsd:enumeration value="Suriname" />
<xsd:enumeration value="Svalbard and Jan Mayen Islands" />
<xsd:enumeration value="Swaziland" />
<xsd:enumeration value="Sweden" />
<xsd:enumeration value="Switzerland" />
<xsd:enumeration value="Syrian Arab Republic" />
<xsd:enumeration value="Taiwan" />
<xsd:enumeration value="Tajikistan" />
<xsd:enumeration value="Tanzania" />
<xsd:enumeration value="Thailand" />
<xsd:enumeration value="Timor-Leste (East Timor)" />
<xsd:enumeration value="Togo" />
<xsd:enumeration value="Tokelau" />
<xsd:enumeration value="Tonga" />
<xsd:enumeration value="Trinidad & Tobago" />
<xsd:enumeration value="Tunisia" />
<xsd:enumeration value="Turkey" />
<xsd:enumeration value="Turkmenistan" />
<xsd:enumeration value="Turks and Caicos Islands" />
<xsd:enumeration value="Tuvalu" />
<xsd:enumeration value="U.S.Virgin Islands" />
<xsd:enumeration value="Uganda" />
<xsd:enumeration value="Ukraine" />
<xsd:enumeration value="United Arab Emirates" />
<xsd:enumeration value="United Republic of Tanzania" />
<xsd:enumeration value="Uruguay" />
<xsd:enumeration value="US Minor Outlying Islands" />
<xsd:enumeration value="Uzbekistan" />
<xsd:enumeration value="Vanuatu" />
<xsd:enumeration value="Venezuela" />
<xsd:enumeration value="Viet Nam" />
<xsd:enumeration value="Wallis and Futuna" />
<xsd:enumeration value="Western Sahara" />
<xsd:enumeration value="Yemen" />
<xsd:enumeration value="Zambia" />
<xsd:enumeration value="Zimbabwe" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="phone" minOccurs="0" type="xsd:string" />
<xsd:element name="fax" minOccurs="0" type="xsd:string" />
<xsd:element name="mobile" minOccurs="0" type="xsd:string" />
<xsd:element name="ebriefsubscribe" minOccurs="0" type="xsd:boolean">
<xsd:annotation>
<xsd:documentation>Set to true to subscribe the user to the LEAF eBrief</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
Example Request
POST https://api.leaf.eco/r1/register.eb HTTP/1.1
Accept: text/xml
Content-Type: text/xml; charset=utf-8
<?xml version="1.0" encoding="utf-8"?>
<registration>
<title>xsd:string</title>
<forename>xsd:string</forename>
<surname>xsd:string</surname>
<email>xsd:string</email>
<position>xsd:string</position>
<address>xsd:string</address>
<county>xsd:string</county>
<postcode>xsd:string</postcode>
<country>xsd:string</country>
<phone>xsd:string</phone>
<fax>xsd:string</fax>
<mobile>xsd:string</mobile>
<ebriefsubscribe>xsd:boolean</ebriefsubscribe>
</registration>
Response Schema
<?xml version="1.0" encoding="utf-8"?>
<xsd:schema elementFormDefault="qualified" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<xsd:element name="registeraction">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="action">
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:enumeration value="RegistrationSuccess">
<xsd:annotation>
<xsd:documentation>The user was registered successfully</xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:enumeration value="DuplicateEmailAddress">
<xsd:annotation>
<xsd:documentation>An account already exists for the given email address</xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:enumeration value="SendFailed">
<xsd:annotation>
<xsd:documentation>Email could not be sent</xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
Example Response
HTTP/1.1 200 OK
Content-Type: text/xml
<?xml version="1.0" encoding="utf-8"?>
<registeraction>
<action>xsd:string</action>
</registeraction>
Example Request
POST https://api.leaf.eco/r1/register.eb HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
{"title":String,
"forename":String,
"surname":String,
"email":String,
"position":String,
"address":String,
"county":String,
"postcode":String,
"country":String,
"phone":String,
"fax":String,
"mobile":String,
"ebriefsubscribe":Boolean}
Example Response
HTTP/1.1 200 OK
Content-Type: application/json
{"action":String}
Status and Error Codes
| HTTP Status | Error Code | Description |
| 400 | DataError:country:RequiredRule | . |
| 400 | DataError:email:MatchRule | Please enter a valid email address |
| 400 | DataError:email:RequiredRule | Please enter your email address |
| 400 | DataError:surname:RequiredRule | Surname is required |
| 400 | DataError:title:RequiredRule | Title is required |