### Example GET Request Parameters Source: https://docs.melissa.com/cloud-api/cloud-api-packages/personator-identity-package.html Configures request parameters with concrete example values. ```C# personatorIdentity.SetValue("Action", "check"); personatorIdentity.SetValue("FullName", "Raymond Melissa"); personatorIdentity.SetValue("AddressLine1", "22382 Avenida Empresa"); personatorIdentity.SetValue("Locality", "Rancho Santa Margarita"); personatorIdentity.SetValue("AdministrativeArea", "CA"); personatorIdentity.SetValue("Postal", "92688"); personatorIdentity.SetValue("Country", "United States"); ``` ```Python personator_identity.set_value("action", "check") personator_identity.set_value("full_name", "Raymond Melissa") personator_identity.set_value("address_line1", "22382 Avenida Empresa") personator_identity.set_value("locality", "Rancho Santa Margarita") personator_identity.set_value("administrative_area", "CA") personator_identity.set_value("postal", "92688") personator_identity.set_value("country", "United States") ``` -------------------------------- ### Execute Unison installation script Source: https://docs.melissa.com/software/unison/unison-quickstart.html Run the installation script with root privileges to begin the setup process. ```bash sudo ./install.sh ``` -------------------------------- ### Example GET Request Configuration using Direct Property Access (Python) Source: https://docs.melissa.com/cloud-api/cloud-api-packages/reverse-geocoder-package.html Example demonstrating how to set latitude, longitude, and max_records using direct property access. ```python reverse_geo_coder.latitude = "33.637520" reverse_geo_coder.longitude = "-117.606920" reverse_geo_coder.max_records = "3" ``` -------------------------------- ### Example GET Request Configuration using Direct Property Access (C#) Source: https://docs.melissa.com/cloud-api/cloud-api-packages/reverse-geocoder-package.html Example demonstrating how to set Latitude, Longitude, and MaxRecords using direct property access. ```csharp reverseGeoCoder.Latitude = "33.637520"; reverseGeoCoder.Longitude = "-117.606920"; reverseGeoCoder.MaxRecords = "3"; ``` -------------------------------- ### Example GET Request Configuration using set_value (Python) Source: https://docs.melissa.com/cloud-api/cloud-api-packages/reverse-geocoder-package.html Example demonstrating how to set latitude, longitude, and max_records using the set_value method. ```python reverse_geo_coder.set_value("latitude", "33.637520") reverse_geo_coder.set_value("longitude", "-117.606920") reverse_geo_coder.set_value("max_records", "3") ``` -------------------------------- ### GET JSON Example Source: https://docs.melissa.com/cloud-api/personator-search/personator-search-reference-guide.html Example of a GET request in JSON format, including headers and response. ```APIDOC ## GET /api/personator/search ### Description Performs a search using the Personator API to retrieve records based on specified criteria. ### Method GET ### Endpoint `/api/personator/search` ### Headers ``` Content-Type: application/json Accept: application/json ``` ### Response #### Success Response (200) - **TransmissionResults** (string) - Result codes from the service. - **TransmissionReference** (string) - Pass-through of the input TransmissionReference field. - **TotalPages** (string) - The number of total pages returned by the request. - **TotalRecords** (string) - The number of total records returned by the request, up to a maximum of 500. - **Version** (string) - The current service version number. - **Records** (array) - An array of returned records. - **RecordID** (string) - The ID of the record. - **Results** (string) - Result codes for the specific record. - **FullName** (string) - The full name of the individual. - **FirstName** (string) - The first name of the individual. - **MiddleName** (string) - The middle name of the individual. - **LastName** (string) - The last name of the individual. - **Suffix** (string) - The suffix of the name. - **DateOfBirth** (string) - The date of birth. - **DateOfDeath** (string) - The date of death. - **MelissaIdentityKey** (string) - The Melissa Identity Key. - **CurrentAddress** (object) - The current address details. - **AddressLine1** (string) - The first line of the address. - **Suite** (string) - The suite or apartment number. - **City** (string) - The city. - **State** (string) - The state. - **PostalCode** (string) - The postal code. - **Plus4** (string) - The plus-four extension of the postal code. - **MelissaAddressKey** (string) - The Melissa Address Key. - **MelissaAddressKeyBase** (string) - The Melissa Address Key Base. - **MoveDate** (string) - The date of the move. - **PreviousAddresses** (array) - An array of previous addresses. - **PhoneRecords** (array) - An array of phone records. - **phoneNumber** (string) - The phone number. - **EmailRecords** (array) - An array of email records. - **email** (string) - The email address. #### Response Example ```json { "TransmissionResults": "US01", "TransmissionReference": "Test", "TotalPages": "1", "TotalRecords": "1", "Version": "9.2.5.1145", "Records": [ { "RecordID": "1", "Results": "VR01", "FullName": "Melissa MelissaData Data", "FirstName": "Melissa", "MiddleName": "MelissaData", "LastName": "Data", "Suffix":"", "DateOfBirth": "", "DateOfDeath": "", "MelissaIdentityKey": "", "CurrentAddress": { "AddressLine1": "22382 Avenida Empresa", "Suite": "", "City": "Rancho Santa Margarita", "State": "CA", "PostalCode": "92688", "Plus4": "2112", "MelissaAddressKey": "8008006245", "MelissaAddressKeyBase": "", "MoveDate":"" }, "PreviousAddresses": [], "PhoneRecords": [ { "phoneNumber": "9498583000" } ], "EmailRecords": [ { "email": "tech@melissa.com" } ] } ] } ``` ``` -------------------------------- ### Setup and Initialization Methods Source: https://docs.melissa.com/on-premise-api/global-address-object/global-address-object-reference-guide.html Functions for initializing the Global Address Object, setting license keys, and configuring data file paths. ```APIDOC ## POST /api/initializeDataFiles ### Description Initializes the reference data files for the Global Address Object. ### Method POST ### Endpoint /api/initializeDataFiles ### Parameters This function takes no parameters. ### Request Example ```json { "action": "InitializeDataFiles" } ``` ### Response #### Success Response (200) - **Initialization Status** (ProgramStatus) - Indicates the status of the data file initialization. ``` ```APIDOC ## POST /api/setLicenseString ### Description Sets the License Key for the Global Address Object. This can also be set via an environmental variable. ### Method POST ### Endpoint /api/setLicenseString ### Parameters #### Request Body - **License** (String) - Required - The license key string. ### Request Example ```json { "action": "SetLicenseString", "License": "YOUR_LICENSE_KEY" } ``` ### Response #### Success Response (200) - **Successful** (Boolean) - Returns true if the license string was set successfully. ``` ```APIDOC ## POST /api/setPathToGlobalAddrFiles ### Description Sets the physical path to the Global Address Object's reference data files. ### Method POST ### Endpoint /api/setPathToGlobalAddrFiles ### Parameters #### Request Body - **FilePath** (String) - Required - The full path to the reference data files. ### Request Example ```json { "action": "SetPathToGlobalAddrFiles", "FilePath": "/path/to/global/address/files" } ``` ### Response #### Success Response (200) This endpoint does not return a specific value upon success (Void return type). ``` -------------------------------- ### GET JSON Response Example Source: https://docs.melissa.com/cloud-api/global-ip/global-ip-reference-guide.html Example response structure for a GET request to the IP Locator service. ```json { "Version": "6.2.0.1122", "TransmissionReference": "IP Locator Test", "TransmissionResults": "", "Records": [ { "City": "Rancho Santa Margarita", "ConnectionSpeed": "broadband", "ConnectionType": "wifi", "Continent": "North America", "CountryAbbreviation": "US", "CountryName": "United States", "DomainAddress1":"DomainsByProxy.com2155 E Warner Rd", "DomainAdministrativeArea": "Arizona", "DomainAgeEstimated": "8172", "DomainAvailability": "UNAVAILABLE", "DomainCountry": "UNITED STATES", "DomainCountryCode": "US", "DomainCreatedDate": "2000-10-16T20:48:37", "DomainEmail": " ", "DomainExpirationDate": "2023-10-16T20:48:36", "DomainLocality": "Tempe", "DomainName": "melissadata.com", "DomainOrganization": "Domains By Proxy, LLC", "DomainPostalCode": "85284", "DomainPrivateProxy": "1", "DomainUpdatedDate": "2022-10-17T07:46:22", "DST": "Y", "IPAddress": "12.203.219.6", "ISPName": "Att Services Inc.", "Latitude": "33.650000", "Longitude": "-117.590000", "PostalCode": "92688", "ProxyDescription": "att", "ProxyType": " ", "RecordID": "1", "Region": "California", "Result": "IS01", "TimeZoneCode": "PST", "TimeZoneName": "Pacific Standard Time", "UTC": "-08:00" } ] } ``` -------------------------------- ### Set License and Add Records with Example Values (Python) Source: https://docs.melissa.com/cloud-api/cloud-api-packages/global-ip-package.html Example of setting the license and adding records with specific IDs and IP addresses. Replace MELISSA_LICENSE_KEY with your license. ```python global_ip = GlobalIP(MELISSA_LICENSE_KEY) global_ip.add_record(GlobalIPRecordRequest( record_id = "1", ip_address = "12.203.219.6" )) global_ip.add_record(GlobalIPRecordRequest( record_id = "2", ip_address = "139.101.81.42" )) ``` -------------------------------- ### GET XML Response Example Source: https://docs.melissa.com/cloud-api/property/property-reference-guide.html This is an example of an XML response for a GET request, representing property deed information. ```xml 9.4.2.1107 Test YS07 1 20221222 21 0.00 Mohammad A Jamal Farida M Jamal Rogelio Ramirez Kimberly Ramirez Texas American Title Co. 0 ``` -------------------------------- ### GET JSON Response Example Source: https://docs.melissa.com/cloud-api/street-route/street-route-reference-guide.html Example JSON response for a GET request to find distance and drive time. ```json { "Results": "SR01", "Units": "mi", "TransmissionResult": "", "TravelTime": "00:05:05", "TotalDrivingDistance": "1.866595", "TransmissionReference": "Test", "Version": "1.4.1.0" } ``` -------------------------------- ### Set License and Add Records with Example Values (C#) Source: https://docs.melissa.com/cloud-api/cloud-api-packages/global-ip-package.html Example of setting the license and adding records with specific IDs and IP addresses. Replace MELISSA_LICENSE_KEY with your license. ```csharp globalIP.SetLicense(MELISSA_LICENSE_KEY); globalIP.AddRecord(new GlobalIPRecordRequest { RecordID = "1", IPAddress = "12.203.219.6" }); globalIP.AddRecord(new GlobalIPRecordRequest { RecordID = "2", IPAddress = "139.101.81.42" }); ``` -------------------------------- ### GET JSON Response Example Source: https://docs.melissa.com/cloud-api/property/property-reference-guide.html This is an example of a JSON response for a GET request, typically used for retrieving property deed information. ```json { "Version": "9.4.2.1107", "TransmissionReference": "Test", "Results": "YS07", "TotalRecords": 1, "Records": [ { "DocInfo": { "RecordingDate": "20221222" }, "TxDefInfo": { "TransactionType": "21" }, "TxAmtInfo": { "TransferAmount": "0.00" }, "PropertyAddress": {}, "PrimaryGrantor": { "Name1Full": "Mohammad A Jamal", "Name2Full": "Farida M Jamal" }, "SecondaryGrantor": {}, "PrimaryGrantee": { "Name1Full": "Rogelio Ramirez", "Name2Full": "Kimberly Ramirez" }, "SecondaryGrantee": {}, "TitleCompInfo": { "StandardizedName": "Texas American Title Co." }, "Mortgage1": { "RecordingDate": "", "Type": "", "Amount": "0", "LenderFullName": "", "TermDate": "", "InterestRate": "" }, "Mortgage2": {}, "Valuation": {} } ] } ``` -------------------------------- ### GET JSON Response Example Source: https://docs.melissa.com/on-premise-api/geocoder-container/geocoder-container-reference-guide.html Example of a JSON response for a GET request. This structure details geocoding results for a given address. ```json { "TransmissionResults": "", "TransmissionReference": "test", "Version": "8.4.1.17401", "TotalRecords": 1, "Records": [ { "RecordID": "", "Latitude": "33.637562", "Longitude": "-117.606887", "CensusTract": "032053", "CensusBlock": "1002", "CountyFIPS": "06059", "CountyName": "Orange", "PlaceCode": "0659587", "PlaceName": "Rancho Santa Margarita", "TimeZoneCode": "08", "TimeZone": "Pacific Time", "CBSACode": "31080", "CBSATitle": "Los Angeles-Long Beach-Anaheim, CA", "CBSALevel": "Metropolitan Statistical Area", "CBSADivisionCode": "11244", "CBSADivisionTitle": "Anaheim-Santa Ana-Irvine, CA", "CBSADivisionLevel": "Metropolitan Statistical Area", "CensusKey": "060590320531002", "CensusKeyDecennial": "060590320531005", "CountySubdivisionCode": "91977", "CountySubdivisionName": "Mission Viejo CCD", "ElementarySchoolDistrictCode": "", "ElementarySchoolDistrictName": "", "SecondarySchoolDistrictCode": "", "SecondarySchoolDistrictName": "", "StateDistrictLower": "071", "StateDistrictUpper": "038", "UnifiedSchoolDistrictCode": "07440", "UnifiedSchoolDistrictName": "Capistrano Unified School District", "BlockSuffix": "", "Results": "GS05", "StatusCode": "B", "SourceLevel": "BC" } ] } ``` -------------------------------- ### Initialize Data Files and Handle Status Source: https://docs.melissa.com/on-premise-api/geocoder-object/geocoder-object-quickstart.html Configure data file paths and initialize the object, checking the ProgramStatus to ensure successful setup. ```C# // Set data paths for objects mdGeoObj.SetPathToGeoCodeDataFiles(PATH_TO_DATA_FILES); mdGeoObj.SetPathToGeoCanadaDataFiles(PATH_TO_DATA_FILES); mdGeoObj.SetPathToGeoPointDataFiles(PATH_TO_DATA_FILES); mdGeo.ProgramStatus pStatus = mdGeoObj.InitializeDataFiles(); // Handle potential issues while initializing the data files if (pStatus != mdGeo.ProgramStatus.ErrorNone) { Console.WriteLine("Fail to Initialize Object."); Console.WriteLine(pStatus); return; } ``` ```C++ // Set data paths for objects mdGeoObj->SetPathToGeoCodeDataFiles(PATH_TO_DATA_FILES.c_str()); mdGeoObj->SetPathToGeoCanadaDataFiles(PATH_TO_DATA_FILES.c_str()); mdGeoObj->SetPathToGeoPointDataFiles(PATH_TO_DATA_FILES.c_str()); mdGeo::ProgramStatus pStatus = mdGeoObj->InitializeDataFiles(); if (pStatus != mdGeo::ProgramStatus::ErrorNone) { cout << "Failed to Initialize Object." << endl; cout << pStatus << endl; return; } ``` ```Java // Set data paths for objects mdGeoObj.SetPathToGeoCodeDataFiles(PATH_TO_DATA_FILES); mdGeoObj.SetPathToGeoCanadaDataFiles(PATH_TO_DATA_FILES); mdGeoObj.SetPathToGeoPointDataFiles(PATH_TO_DATA_FILES); mdGeo.ProgramStatus pStatus = mdGeoObj.InitializeDataFiles(); if (pStatus != mdGeo.ProgramStatus.ErrorNone) { // Problem during initialization System.out.println("Failed to Initialize Object."); System.out.println(pStatus); return; } ``` ```Python3 # Set data paths for objects md_geo_obj.SetPathToGeoCodeDataFiles(PATH_TO_DATA_FILES) md_geo_obj.SetPathToGeoCanadaDataFiles(PATH_TO_DATA_FILES) md_geo_obj.SetPathToGeoPointDataFiles(PATH_TO_DATA_FILES) p_status = md_geo_obj.InitializeDataFiles() if (p_status != mdGeo_pythoncode.ProgramStatus.ErrorNone): print("Failed to Initialize Object.") print(p_status) return ``` -------------------------------- ### Set Input Parameters and Add Records Example Source: https://docs.melissa.com/cloud-api/cloud-api-packages/global-email-package.html Example usage of setting a license and adding records individually. ```C# globalEmail.SetLicense(MELISSA_LICENSE_KEY); globalEmail.AddRecord( new GlobalEmailRecordRequest { RecordID = "1", Email = "info@melissa.com" } ); globalEmail.AddRecord( new GlobalEmailRecordRequest { RecordID = "2", Email = "test@melissa.com" } ); ``` ```Python global_email = GlobalEmail(MELISSA_LICENSE_KEY) global_email.add_record(GlobalEmailRecordRequest( record_id = "1", email = "info@melissa.com" } )) global_email.add_record(GlobalEmailRecordRequest( record_id = "2", email = "test@melissa.com" )) ``` -------------------------------- ### DoGeoCode GET Request Example Source: https://docs.melissa.com/on-premise-api/geocoder-container/geocoder-container-reference-guide.html Example of a cURL command for performing geocoding via a GET request. Requires a license key and zip code. ```curl curl -X GET \ "http://{{machine_name}}:{{port_number}}/V4/WEB/Geo/DoGeoCode?\ t=test\ &id={{license_key}}\ &zip=92688\ &dp=82" \ -H "accept: application/json" ``` -------------------------------- ### Initialize Data Files Source: https://docs.melissa.com/on-premise-api/matchup-object-global/matchup-object-global-reference-guide.html Prepares the MatchUp Object for use by opening necessary data files. Must be called after SetLicenseString and SetPathToMatchUpFiles. ```text mdMUHybridInitializeDataFiles(); ``` -------------------------------- ### Initialize Data Files Source: https://docs.melissa.com/on-premise-api/matchup-object-global/matchup-object-global-reference-guide.html Opens data files and prepares the MatchUp Object Global. Must be called after SetLicenseString and SetPathToMatchUpFiles. ```text mdMUReadWriteInitializeDataFiles(String EncodingFormat); ``` -------------------------------- ### Example GET Request Parameters Source: https://docs.melissa.com/cloud-api/cloud-api-packages/street-route-package.html Example usage of the SetValue method with specific coordinate values. ```C# streetRoute.SetValue("StartLatitude", "33.637520"); streetRoute.SetValue("StartLongitude", "-117.606920"); streetRoute.SetValue("EndLatitude", "33.649870"); streetRoute.SetValue("EndLongitude", "-117.582960"); ``` ```Python street_route.set_value("start_latitude", "33.637520") street_route.set_value("start_longitude", "-117.606920") street_route.set_value("end_latitude", "33.649870") street_route.set_value("end_longitude", "-117.582960") ``` -------------------------------- ### Example Parameter Configuration Source: https://docs.melissa.com/cloud-api/cloud-api-packages/personator-search-package.html Demonstrates setting specific values for a Personator Search request. ```C# personatorSearch.SetValue("FullName", "Raymond Melissa"); personatorSearch.SetValue("AddressLine1", "22382 Avenida Empresa"); personatorSearch.SetValue("City", "Rancho Santa Margarita"); personatorSearch.SetValue("State", "CA"); personatorSearch.SetValue("Postal", "92688"); personatorSearch.SetValue("Cols", "GrpAll"); ``` ```Python personator_search.set_value("full_name", "Raymond Melissa") personator_search.set_value("address_line_1", "22382 Avenida Empresa") personator_search.set_value("city", "Rancho Santa Margarita") personator_search.set_value("state", "CA") personator_search.set_value("postal", "92688") personator_search.set_value("cols", "GrpAll") ``` -------------------------------- ### Get Distance - GET Request Example Source: https://docs.melissa.com/cloud-api/street-route/street-route-reference-guide.html Use this GET request to find the distance and drive time between two points. Replace {{customerId}} with your license key. ```curl curl -X GET "https://streetroute.melissadata.net/v1/WEB/StreetRoute/getDistance?&id={{customerId}}&opt=avoid:tunnels,routeType:shortest&t=Test&units=&endLatitude=33.649870&endLongitude=-117.582960&format=JSON&startLatitude=33.637520&startLongitude=-117.606920" \ -H "Content-Type:application/json" \ -H "Accept:application/json" ``` -------------------------------- ### Configure Parameters via Direct Property Access Example Source: https://docs.melissa.com/cloud-api/cloud-api-packages/smart-mover-package.html Example implementation showing direct property assignment with populated values. ```C# smartMover.PafId = PAF_ID; smartMover.Company = "Melissa"; smartMover.FullName = "Raymond Melissa"; smartMover.AddressLine1 = "22382 Avenida Empresa"; smartMover.City = "Rancho Santa Margarita"; smartMover.State = "CA"; smartMover.Postal = "92688"; smartMover.Country = "US"; ``` ```Python smart_mover.paf_id = PAF_ID smart_mover.company = "Melissa" smart_mover.full_name = "Raymond Melissa" smart_mover.address_line_1 = "22382 Avenida Empresa" smart_mover.city = "Rancho Santa Margarita" smart_mover.state = "CA" smart_mover.postal = "92688" smart_mover.country = "US" ``` -------------------------------- ### GET /v1/doContactVerify Source: https://docs.melissa.com/cloud-api/personator-identity/personator-identity-reference-guide.html This GET request example demonstrates how to call the doContactVerify endpoint with query parameters for contact verification. ```APIDOC ## GET /v1/doContactVerify ### Description This endpoint performs contact verification by executing specified actions and options using GET request parameters. ### Method GET ### Endpoint https://globalpersonator.melissadata.net/v1/doContactVerify ### Parameters #### Query Parameters - **t** (string) - Optional - Transmission reference. - **id** (string) - Required - Your Melissa license key. - **act** (string) - Optional - Specifies the actions to perform (e.g., "check"). - **full** (string) - Optional - The full name to verify. - **phone** (string) - Optional - The phone number to verify. - **email** (string) - Optional - The email address to verify. - **a1** (string) - Optional - The first line of the address. - **loc** (string) - Optional - The city or locality. - **admarea** (string) - Optional - The state or administrative area. - **postal** (string) - Optional - The postal code. - **ctry** (string) - Optional - The country code. ### Request Example ```curl curl -X GET "https://globalpersonator.melissadata.net/v1/doContactVerify?\n&t=Test\n&id={{customerId}}\n&act=check\n&full=John%20Smith\n&phone=1-800-635-4772\n&email=info@melissa.com\n&a1=22382%20Avenida%20Empresa\n&loc=Rancho%20Santa%20Margarita\n&admarea=CA\n&postal=92688\n&ctry=US" \n-H "Content-Type: application/json" \n-H "Accept: application/json" ``` ### Response #### Success Response (200) - **ResponseStatus** (object) - Contains status information about the request. - **PrimaryResult** (object) - Contains the primary verification results. - **SecondaryResults** (array) - Contains additional verification results if applicable. #### Response Example ```json { "ResponseStatus": { "Success": true, "Errors": [], "Warnings": [] }, "PrimaryResult": { "CustomerID": "{{customerId}}", "RecordID": "12345", "Status": "Success" }, "SecondaryResults": [] } ``` ``` -------------------------------- ### Get Distance with Waypoints (GET) Source: https://docs.melissa.com/cloud-api/street-route/street-route-quickstart.html This GET request calculates the route distance and drive time between a start point and a destination, including one or more intermediate waypoints. Units can be specified. ```curl curl -X GET "https://streetroute.melissadata.net/v1/WEB/StreetRoute/getDistanceMultipoint?&id={{customerId}}&opt=avoid:tunnels&t=Test&units=mi&points=42.211479,-70.999908:42.201926,-71.007090:42.211848, -71.019438:42.214976, -71.0045472" \ -H "Content-Type:application/json" \ -H "Accept:application/json" ``` -------------------------------- ### Set Post Body with Example Data - Python Source: https://docs.melissa.com/cloud-api/cloud-api-packages/personator-consumer-package.html This Python example shows how to set the post body with sample address data. Remember to replace `MELISSA_LICENSE_KEY` with your valid license key. ```python personator_consumer.set_post_body(PersonatorConsumerPostRequest( customer_id = MELISSA_LICENSE_KEY, records=[ PersonatorConsumerRecordRequest( record_id = "1", full_name = "Raymond Melissa", address_line1 = "22382 Avenida Empresa", city = "Rancho Santa Margarita", state = "CA", postal_code = "92688" ), PersonatorConsumerRecordRequest( record_id = "2", full_name = "John Melissa", address_line1 = "22382 Avenida Empresa", city = "Rancho Santa Margarita", state = "CA", postal_code = "92688" ) ] )) ``` -------------------------------- ### Perform SSN Lookup via GET Source: https://docs.melissa.com/cloud-api/ssn-name-match/ssn-name-match-reference-guide.html Example of a GET request to the doLookup endpoint. Replace {{customerId}} with your actual license key. ```bash curl -X GET "https://namessn.melissadata.net/v4/web/SSN/doLookup?\ &format=json\ &id={{customerId}}\ &first=John\ &full=John%20Doe\ &last=Doe\ &ssn=111222333" \ ``` -------------------------------- ### Example: Set Request Parameters using Specialized Methods (Python) Source: https://docs.melissa.com/cloud-api/cloud-api-packages/token-server-package.html Example demonstrating how to set package, ip, and time_span using specialized methods. ```python token_server.set_package("GlobalExpressEntry") token_server.set_ip("") token_server.set_time_span("0015") ``` -------------------------------- ### Token Server Initialization Source: https://docs.melissa.com/cloud-api/cloud-api-packages/token-server-package.html Demonstrates how to initialize the Token Server client using a license key or environment variable. ```APIDOC ## Token Server Initialization ### Description Initializes the Token Server client with a license key or by reading from environment variables. ### Constructors #### TokenServer(string license) Initializes the Cloud API object with a license key. **Example (C#):** ```csharp TokenServer tokenServer = new TokenServer("MELISSA_LICENSE_KEY"); ``` **Example (Python):** ```python token_server = TokenServer(MELISSA_LICENSE_KEY) ``` #### TokenServer() Initializes the Cloud API object, reading the license key from the environment variable **MD_LICENSE** or a configured set method. **Example (C#):** ```csharp TokenServer tokenServer = new TokenServer() ``` **Example (Python):** ```python token_server = TokenServer() ``` ``` -------------------------------- ### Example GET Request Configuration using SetValue (C#) Source: https://docs.melissa.com/cloud-api/cloud-api-packages/reverse-geocoder-package.html Example demonstrating how to set Latitude, Longitude, and MaxRecords using the SetValue method. ```csharp reverseGeoCoder.SetValue("Latitude", "33.637520"); reverseGeoCoder.SetValue("Longitude", "-117.606920"); reverseGeoCoder.SetValue("MaxRecords", "3"); ``` -------------------------------- ### Submit Remove MIK Request via GET Source: https://docs.melissa.com/cloud-api/contribution/contribution-reference-guide.html Example of using a GET request to remove a MIK. Ensure the license key is provided in the id parameter. ```bash curl -X GET "https://contribution.melissadata.net/V4/WEB/removeMIK?\ &id={{customerId}}\ &t=Test\ &act=delete\ &mik=8008006245\ &respondtoemail=youremail%40melissadata%2Ecom" \ -H "Content-Type:application/json" \ -H "Accept:application/json" ``` -------------------------------- ### Example: Set Request Parameters using Specialized Methods (C#) Source: https://docs.melissa.com/cloud-api/cloud-api-packages/token-server-package.html Example demonstrating how to set Package, Ip, and TimeSpan using specialized methods. ```csharp tokenServer.SetPackage("GlobalExpressEntry"); tokenServer.SetIP(""); tokenServer.SetTimeSpan("0015"); ``` -------------------------------- ### Example: Set IP Directly (Python) Source: https://docs.melissa.com/cloud-api/cloud-api-packages/global-ip-package.html Example demonstrating how to set the IP address to '12.203.219.6' using direct property access. ```python global_ip.ip = "12.203.219.6" ``` -------------------------------- ### Initialize and Make GET Request in Python Source: https://docs.melissa.com/cloud-api/people-business-search/people-business-search-packages-and-samples.html Initializes the People Business Search SDK in Python and makes a GET request with specified parameters. Ensure MELISSA_LICENSE_KEY is set. ```python # Initialize People Business Search people_business = PeopleBusinessSearch(MELISSA_LICENSE_KEY) # Set the parameters people_business.max_records = "10" people_business.match_level = "10" people_business.address_line_1 = "22382 Avenida Empresa" people_business.locality = "RSM" people_business.administrative_area = "CA" people_business.postal = "92688" people_business.any_name = "Melissa Data" # Make the GET request response_object = people_business.get(PeopleBusinessSearchResponse) # Access the response value result_code = response_object.result_code ``` -------------------------------- ### GET Request for IP Location Source: https://docs.melissa.com/cloud-api/global-ip/global-ip-reference-guide.html Example of a GET request to the doIPLocation endpoint to retrieve IP geolocation data. Ensure to replace `{{customerId}}` with your actual license key. ```curl curl -X GET "https://globalip.melissadata.net/v4/WEB/iplocation/doiplocation?&t=&id={{customerId}}&ip="216.231.3.166"&format=JSON" -H "Content-Type:application/json" -H "Accept:application/json" ``` -------------------------------- ### Matching Project Setup Source: https://docs.melissa.com/software/unison/unison-components.html Information on setting up a Matching Project, including naming and privacy options. ```APIDOC ## Matching Project Setup ### Description Details the initial steps for creating a Matching Project within the Unison platform. ### Steps 1. **Title and Description** - **Project Title** (string) - Required. The name for the Matching Project. - **Project Description** (string) - Optional. A description for the project. - **Make this a private project** (boolean) - Checkbox to make the project private. ``` -------------------------------- ### Handle JSON Response Source: https://docs.melissa.com/cloud-api/business-coder/business-coder-reference-guide.html Example JSON response structures for GET and POST requests. ```json { "TransmissionResults": "", "TransmissionReference": "Test", "Version": "7.0.1.1071", "TotalRecords": "1", "Records": [{ "AddressLine1": "22382 Avenida Empresa", "City": "Rancho Santa Margarita", "CompanyName": "Melissa Data", "CurrentCompanyName": "Melissa Data", "MelissaEnterpriseKey": "323318841", "PostalCode": "92688-2112", "RecordID": "1", "Results": "AS01,DA00,DA20,DA30,DA40,DA50,FS01,FS08", "State": "CA", "Suite": "", "TotalContacts": "8" }] } ``` ```json { "TransmissionResults": "", "TransmissionReference": "Test", "Version": "7.0.1.1071", "TotalRecords": "1", "Records": [{ "AddressLine1": "22382 Avenida Empresa", "City": "Rancho Santa Margarita", "CompanyName": "Melissa Data", "CurrentCompanyName": "Melissa Data", "MelissaEnterpriseKey": "323318841", "PostalCode": "92688-2112", "RecordID": "1", "Results": "AS01,DA20,DA30,DA40,DA50,FS01,FS04,GS05", "State": "CA", "Suite": "", "TotalContacts": "8" }] } ``` -------------------------------- ### Example: Set Request Parameters using Direct Property Access (Python) Source: https://docs.melissa.com/cloud-api/cloud-api-packages/token-server-package.html Example demonstrating how to set package, ip, and time_span properties directly. ```python token_server.package = "GlobalExpressEntry" token_server.ip = "" token_server.time_span = "0015" ``` -------------------------------- ### Example: Set IP Directly (C#) Source: https://docs.melissa.com/cloud-api/cloud-api-packages/global-ip-package.html Example demonstrating how to set the IP address to '12.203.219.6' using direct property access. ```csharp globalIP.IP = "12.203.219.6"; ``` -------------------------------- ### Perform Contact Verification via GET Request Source: https://docs.melissa.com/cloud-api/personator-identity/personator-identity-reference-guide.html Example of how to perform contact verification using the doContactVerify endpoint with GET parameters. Ensure to replace `{{customerId}}` with your actual license key. ```curl curl -X GET "https://globalpersonator.melissadata.net/v1/doContactVerify?\n&t=Test\n&id={{customerId}}\n&act=check\n&full=John%20Smith\n&phone=1-800-635-4772\n&email=info@melissa.com\n&a1=22382%20Avenida%20Empresa\n&loc=Rancho%20Santa%20Margarita\n&admarea=CA\n&postal=92688\n&ctry=US" \n-H "Content-Type: application/json" \n-H "Accept: application/json" ``` -------------------------------- ### Example: Set Request Parameters using Direct Property Access (C#) Source: https://docs.melissa.com/cloud-api/cloud-api-packages/token-server-package.html Example demonstrating how to set Package, IP, and TimeSpan properties directly. ```csharp tokenServer.Package = "GlobalExpressEntry"; tokenServer.IP = ""; tokenServer.TimeSpan = "0015"; ``` -------------------------------- ### Perform a Personator Search (GET JSON) Source: https://docs.melissa.com/cloud-api/personator-search/personator-search-reference-guide.html Example of how to perform a consumer search using the doPersonatorSearch endpoint with GET JSON request. Ensure to replace {{customerId}} with your actual license key. ```curl curl -X GET "https://personatorsearch.melissadata.net/WEB/doPersonatorSearch?\ &id={{customerId}}\ &format=JSON\ &t=Test\ &full=Melissa%20Data\ &a1=22382%20Avenida%20Empresa\ &city=Rancho%20Santa%20Margarita\ &state=CA\ &postal=92688" ``` -------------------------------- ### Initialize and Make POST Request in Python Source: https://docs.melissa.com/cloud-api/people-business-search/people-business-search-packages-and-samples.html Initializes the People Business Search SDK in Python and makes a POST request with a set of records. Ensure MELISSA_LICENSE_KEY is set. ```python # Initialize People Business Search people_business = PeopleBusinessSearch(MELISSA_LICENSE_KEY) # Create a set of requests and set their parameters people_business.add_record(PeopleBusinessSearchRecordRequest ( max_records = "10", match_level = "10", address_line_1 = "22382 Avenida Empresa", locality = "RSM", administrative_area = "CA", postal_code = "92688", any_name = "Melissa Data" )) # Make the POST request response_object = people_business.post(PeopleBusinessSearchResponse) # Access the response value result_code = response_object.result_code ``` -------------------------------- ### ContactVerify API - GET Request (XML) Source: https://docs.melissa.com/cloud-api/personator-consumer/personator-consumer-reference-guide.html This example demonstrates how to perform a contact verification using a GET request with XML output. It includes parameters for address, city, state, and customer ID. ```APIDOC ## GET /v3/WEB/ContactVerify/doContactVerify ### Description Performs contact verification and data appending using a GET request. Returns results in XML format. ### Method GET ### Endpoint https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify ### Parameters #### Query Parameters - **act** (string) - Required - Action to perform (e.g., Append). - **cols** (string) - Optional - Columns to include in the response. - **id** (string) - Required - Your customer license key. - **opt** (string) - Optional - Options for the action (e.g., Append:blank). - **t** (string) - Optional - Transmission reference. - **a1** (string) - Optional - Address line 1. - **a2** (string) - Optional - Address line 2. - **bday** (string) - Optional - Birth day. - **bmo** (string) - Optional - Birth month. - **byr** (string) - Optional - Birth year. - **city** (string) - Optional - City. - **comp** (string) - Optional - Company name. - **ctry** (string) - Optional - Country. - **email** (string) - Optional - Email address. - **ff** (string) - Optional - Free form field. - **first** (string) - Optional - First name. - **format** (string) - Required - Output format (JSON or XML). - **full** (string) - Optional - Full name. - **ip** (string) - Optional - IP address. - **last** (string) - Optional - Last name. - **lastline** (string) - Optional - Last line of address. - **mak** (string) - Optional - Melissa Address Key. - **phone** (string) - Optional - Phone number. - **postal** (string) - Optional - Postal code. - **state** (string) - Optional - State or province. ### Request Example ```bash curl -X GET "https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify?&act=Append&cols=&id={{customerId}}&opt=Append:blank&t=Test&a1=22382%20Avenida%20Empresa&a2=&bday=&bmo=&byr=&city=Rancho%20Santa%20Margarita&comp=&ctry=&email=&ff=&first=&format=XML&full=&ip=&last=&lastline=&mak=&phone=&postal=&state=California" -H "Content-Type: application/xml" -H "Accept: application/xml" ``` ### Response #### Success Response (200) - **Response fields depend on the `act` and `cols` parameters.** #### Response Example ```xml Success 1 22382 AVENIDA EMPRESA RANCHO SANTA MARGARITA CA 92688 ``` ``` -------------------------------- ### Example Parameter Configuration Source: https://docs.melissa.com/cloud-api/cloud-api-packages/smart-mover-package.html Set input parameters using the SetValue method with concrete values. ```C# smartMover.SetValue("PafId", PAF_ID); smartMover.SetValue("Company", "Melissa"); smartMover.SetValue("FullName", "Raymond Melissa"); smartMover.SetValue("AddressLine1", "22382 Avenida Empresa"); smartMover.SetValue("City", "Rancho Santa Margarita"); smartMover.SetValue("State", "CA"); smartMover.SetValue("Postal", "92688"); smartMover.SetValue("Country", "US"); ``` ```Python smart_mover.set_value("paf_id", PAF_ID) smart_mover.set_value("company", "Melissa") smart_mover.set_value("full_ame", "Raymond Melissa") smart_mover.set_value("address_line_1", "22382 Avenida Empresa") smart_mover.set_value("city", "Rancho Santa Margarita") smart_mover.set_value("state", "CA") smart_mover.set_value("postal", "92688") smart_mover.set_value("country", "US") ``` -------------------------------- ### ContactVerify API - GET Request (JSON) Source: https://docs.melissa.com/cloud-api/personator-consumer/personator-consumer-reference-guide.html This example demonstrates how to perform a contact verification using a GET request with JSON output. It includes parameters for address, city, state, and customer ID. ```APIDOC ## GET /v3/WEB/ContactVerify/doContactVerify ### Description Performs contact verification and data appending using a GET request. Returns results in JSON format. ### Method GET ### Endpoint https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify ### Parameters #### Query Parameters - **act** (string) - Required - Action to perform (e.g., Append). - **cols** (string) - Optional - Columns to include in the response. - **id** (string) - Required - Your customer license key. - **opt** (string) - Optional - Options for the action (e.g., Append:blank). - **t** (string) - Optional - Transmission reference. - **a1** (string) - Optional - Address line 1. - **a2** (string) - Optional - Address line 2. - **bday** (string) - Optional - Birth day. - **bmo** (string) - Optional - Birth month. - **byr** (string) - Optional - Birth year. - **city** (string) - Optional - City. - **comp** (string) - Optional - Company name. - **ctry** (string) - Optional - Country. - **email** (string) - Optional - Email address. - **ff** (string) - Optional - Free form field. - **first** (string) - Optional - First name. - **format** (string) - Required - Output format (JSON or XML). - **full** (string) - Optional - Full name. - **ip** (string) - Optional - IP address. - **last** (string) - Optional - Last name. - **lastline** (string) - Optional - Last line of address. - **mak** (string) - Optional - Melissa Address Key. - **phone** (string) - Optional - Phone number. - **postal** (string) - Optional - Postal code. - **state** (string) - Optional - State or province. ### Request Example ```bash curl -X GET "https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify?&act=Append&cols=&id={{customerId}}&opt=Append:blank&t=Test&a1=22382%20Avenida%20Empresa&a2=&bday=&bmo=&byr=&city=Rancho%20Santa%20Margarita&comp=&ctry=&email=&ff=&first=&format=JSON&full=&ip=&last=&lastline=&mak=&phone=&postal=&state=California" -H "Content-Type: application/json" -H "Accept: application/json" ``` ### Response #### Success Response (200) - **Response fields depend on the `act` and `cols` parameters.** #### Response Example ```json { "ContactVerifyResponse": { "Status": "Success", "Results": [ { "RecordID": "1", "VerifiedAddress": { "StandardizedAddress": { "Address1": "22382 AVENIDA EMPRESA", "City": "RANCHO SANTA MARGARITA", "State": "CA", "PostalCode": "92688" } } } ] } } ``` ```