Express Entry:ExpressFreeForm: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| Line 12: | Line 12: | ||
The ExpressFreeForm endpoint is provided as a means of retrieving all available U.S. address elements with a Free Form query. ExpressFreeForm returns AddressLine1, City, State, PostalCode, AddressKey, SuiteName, and SuiteCount and the SuiteList and PlusFour lists. | The ExpressFreeForm endpoint is provided as a means of retrieving all available U.S. address elements with a Free Form query. ExpressFreeForm returns AddressLine1, City, State, PostalCode, AddressKey, SuiteName, and SuiteCount and the SuiteList and PlusFour lists. | ||
= | <h3 class="h3grey">Example Call</h3> | ||
<pre> | <pre> | ||
http://expressentry.melissadata.net/web/ExpressFreeForm?format={FORMAT}&id={ID}&ff={FF}&maxrecords={MAXRECORDS} | http://expressentry.melissadata.net/web/ExpressFreeForm?format={FORMAT}&id={ID}&ff={FF}&maxrecords={MAXRECORDS} | ||
</pre> | </pre> | ||
===Schema | :{|class="alternate01" cellspacing="0" | ||
!Requested Field | |||
!Input | |||
!style="border-right:0px;"|Description | |||
|- | |||
|Format | |||
|{XML, JSON} | |||
|The return format of the request. | |||
|- | |||
|ID | |||
|Text | |||
|The License Key or token | |||
|- | |||
|ff | |||
|Search terms delimited by %20 or space. | |||
|The service uses a word-distance algorithm to find and display matches in an intuitive order. | |||
|- | |||
|Maxrecords | |||
|Number | |||
|The maximum number of records to return (required). (Default 10, Maximum 100) | |||
|- | |||
|Opt | |||
|poboxes:true | |||
|US Only: Return P.O. Boxes and military addresses | |||
|} | |||
<h3 class="h3grey">Schema</h3> | |||
;?format= | ;?format= | ||
:The response will be formatted according to the value set here. | :The response will be formatted according to the value set here. | ||
| Line 26: | Line 53: | ||
;&ff= | ;&ff= | ||
:The service uses this term to complete addresses in Free Form. | :The service uses this term to complete addresses in Free Form. The service uses a word-distance algorithm to find and display matches in an intuitive order. | ||
;&maxrecords= | ;&maxrecords= | ||
| Line 32: | Line 59: | ||
:The default value is 10 and the maximum is 100 records. | :The default value is 10 and the maximum is 100 records. | ||
;&opt= | |||
:When set to <code>poboxes:true</code>, U.S. Addresses will return P.O. Boxes and military addresses along with the usual address results. Multiple options for &opt can be delimited by semicolon. | |||
[[Category:Cloud Services]] | [[Category:Cloud Services]] | ||
[[Category:Express Entry]] | [[Category:Express Entry]] | ||
Revision as of 00:53, 23 July 2022
URL
REST
Use URL Standard http://expressentry.melissadata.net/web/ExpressFreeForm Secure https://expressentry.melissadata.net/web/ExpressFreeForm
JSON
Use URL Standard http://expressentry.melissadata.net/jsonp/ExpressFreeForm Secure https://expressentry.melissadata.net/jsonp/ExpressFreeForm
ExpressFreeForm
The ExpressFreeForm endpoint is provided as a means of retrieving all available U.S. address elements with a Free Form query. ExpressFreeForm returns AddressLine1, City, State, PostalCode, AddressKey, SuiteName, and SuiteCount and the SuiteList and PlusFour lists.
Example Call
http://expressentry.melissadata.net/web/ExpressFreeForm?format={FORMAT}&id={ID}&ff={FF}&maxrecords={MAXRECORDS}
Requested Field Input Description Format {XML, JSON} The return format of the request. ID Text The License Key or token ff Search terms delimited by %20 or space. The service uses a word-distance algorithm to find and display matches in an intuitive order. Maxrecords Number The maximum number of records to return (required). (Default 10, Maximum 100) Opt poboxes:true US Only: Return P.O. Boxes and military addresses
Schema
- ?format=
- The response will be formatted according to the value set here.
- Valid values are: XML and JSON.
- &id=
- The ID element can contain your user ID, a complete License Key, or a token.
- &ff=
- The service uses this term to complete addresses in Free Form. The service uses a word-distance algorithm to find and display matches in an intuitive order.
- &maxrecords=
- Maxrecords is provided to control the number of results returned from a request to the service.
- The default value is 10 and the maximum is 100 records.
- &opt=
- When set to
poboxes:true, U.S. Addresses will return P.O. Boxes and military addresses along with the usual address results. Multiple options for &opt can be delimited by semicolon.