Run this command to install the SDK:

npm install cloudmersive-validate-api-client --save

Or add this snippet to your package.json:

  "dependencies": {
    "cloudmersive-validate-api-client": "^1.3.9"

var CloudmersiveValidateApiClient = require('cloudmersive-validate-api-client');
var defaultClient = CloudmersiveValidateApiClient.ApiClient.instance;

// Configure API key authorization: Apikey
var Apikey = defaultClient.authentications['Apikey'];
Apikey.apiKey = 'YOUR API KEY';

var apiInstance = new CloudmersiveValidateApiClient.AddressApi();

var input = new CloudmersiveValidateApiClient.ValidatePostalCodeRequest(); // ValidatePostalCodeRequest | Input parse request

var callback = function(error, data, response) {
  if (error) {
  } else {
    console.log('API called successfully. Returned data: ' + data);
apiInstance.addressValidatePostalCode(input, callback);

Run this command to install the SDK:

pip install cloudmersive-validate-api-client

from __future__ import print_function
import time
import cloudmersive_validate_api_client
from import ApiException
from pprint import pprint

# Configure API key authorization: Apikey
configuration = cloudmersive_validate_api_client.Configuration()
configuration.api_key['Apikey'] = 'YOUR_API_KEY'

# create an instance of the API class
api_instance = cloudmersive_validate_api_client.AddressApi(cloudmersive_validate_api_client.ApiClient(configuration))
input = cloudmersive_validate_api_client.ValidatePostalCodeRequest() # ValidatePostalCodeRequest | Input parse request

    # Validate a postal code, get location information about it
    api_response = api_instance.address_validate_postal_code(input)
except ApiException as e:
    print("Exception when calling AddressApi->address_validate_postal_code: %s\n" % e)

Run this command to install the SDK:

Install-Package Cloudmersive.APIClient.NET.Validate -Version 3.2.0

using System;
using System.Diagnostics;
using Cloudmersive.APIClient.NET.Validate.Api;
using Cloudmersive.APIClient.NET.Validate.Client;
using Cloudmersive.APIClient.NET.Validate.Model;

namespace Example
    public class AddressValidatePostalCodeExample
        public void main()
            // Configure API key authorization: Apikey
            Configuration.Default.AddApiKey("Apikey", "YOUR_API_KEY");

            var apiInstance = new AddressApi();
            var input = new ValidatePostalCodeRequest(); // ValidatePostalCodeRequest | Input parse request

                // Validate a postal code, get location information about it
                ValidatePostalCodeResponse result = apiInstance.AddressValidatePostalCode(input);
            catch (Exception e)
                Debug.Print("Exception when calling AddressApi.AddressValidatePostalCode: " + e.Message );

To install with Maven, add a reference to the repository in pom.xml:


And add a reference to the dependency in pom.xml:


To install with Gradle, add it in your root build.gradle at the end of repositories:

allprojects {
	repositories {
		maven { url '' }

And add the dependency in build.gradle:

dependencies {
        implementation 'com.github.Cloudmersive:Cloudmersive.APIClient.Java:v4.25'

// Import classes:
//import com.cloudmersive.client.invoker.ApiClient;
//import com.cloudmersive.client.invoker.ApiException;
//import com.cloudmersive.client.invoker.Configuration;
//import com.cloudmersive.client.invoker.auth.*;
//import com.cloudmersive.client.AddressApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Apikey
ApiKeyAuth Apikey = (ApiKeyAuth) defaultClient.getAuthentication("Apikey");
Apikey.setApiKey("YOUR API KEY");
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)

AddressApi apiInstance = new AddressApi();
ValidatePostalCodeRequest input = new ValidatePostalCodeRequest(); // ValidatePostalCodeRequest | Input parse request
try {
    ValidatePostalCodeResponse result = apiInstance.addressValidatePostalCode(input);
} catch (ApiException e) {
    System.err.println("Exception when calling AddressApi#addressValidatePostalCode");

Run this command to install the SDK:

composer require cloudmersive/cloudmersive_validate_api_client

require_once(__DIR__ . '/vendor/autoload.php');

// Configure API key authorization: Apikey
$config = Swagger\Client\Configuration::getDefaultConfiguration()->setApiKey('Apikey', 'YOUR_API_KEY');

$apiInstance = new Swagger\Client\Api\AddressApi(
    new GuzzleHttp\Client(),
$input = new \Swagger\Client\Model\ValidatePostalCodeRequest(); // \Swagger\Client\Model\ValidatePostalCodeRequest | Input parse request

try {
    $result = $apiInstance->addressValidatePostalCode($input);
} catch (Exception $e) {
    echo 'Exception when calling AddressApi->addressValidatePostalCode: ', $e->getMessage(), PHP_EOL;

Add the Objective-C client to your Podfile:

pod 'CloudmersiveValidateApiClient', '~> 1.0'

CMDefaultConfiguration *apiConfig = [CMDefaultConfiguration sharedConfig];

// Configure API key authorization: (authentication scheme: Apikey)
[apiConfig setApiKey:@"YOUR_API_KEY" forApiKeyIdentifier:@"Apikey"];

CMValidatePostalCodeRequest* input = [[CMValidatePostalCodeRequest alloc] init]; // Input parse request

CMAddressApi*apiInstance = [[CMAddressApi alloc] init];

// Validate a postal code, get location information about it
[apiInstance addressValidatePostalCodeWithInput:input
          completionHandler: ^(CMValidatePostalCodeResponse* output, NSError* error) {
                        if (output) {
                            NSLog(@"%@", output);
                        if (error) {
                            NSLog(@"Error calling CMAddressApi->addressValidatePostalCode: %@", error);

Add the Ruby client to your Gemfile:

gem 'cloudmersive-validate-api-client', '~> 2.1.6'

# load the gem
require 'cloudmersive-validate-api-client'
# setup authorization
CloudmersiveValidateApiClient.configure do |config|
  # Configure API key authorization: Apikey
  config.api_key['Apikey'] = 'YOUR API KEY'
  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
  #config.api_key_prefix['Apikey'] = 'Bearer'

api_instance =

input = # ValidatePostalCodeRequest | Input parse request

  #Validate a postal code, get location information about it
  result = api_instance.address_validate_postal_code(input)
  p result
rescue CloudmersiveValidateApiClient::ApiError => e
  puts "Exception when calling AddressApi->address_validate_postal_code: #{e}"

Download and copy the /client folder into your Apex project:

Download Apex Client

SwagAddressApi api = new SwagAddressApi();
SwagClient client = api.getClient();

// Configure API key authorization: Apikey
ApiKeyAuth Apikey = (ApiKeyAuth) client.getAuthentication('Apikey');
Apikey.setApiKey('YOUR API KEY');

Map<String, Object> params = new Map<String, Object>{
    'input' => SwagValidatePostalCodeRequest.getExample()

try {
    // cross your fingers
    SwagValidatePostalCodeResponse result = api.addressValidatePostalCode(params);
} catch (Swagger.ApiException e) {
    // ...handle your exceptions

Install libcurl in your C/C++ project:

CURL *curl;
CURLcode res;
curl = curl_easy_init();
if(curl) {
     curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
     curl_easy_setopt(curl, CURLOPT_URL, "");
     curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
     curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");
     struct curl_slist *headers = NULL;
     headers = curl_slist_append(headers, "Content-Type: application/json");
     headers = curl_slist_append(headers, "Apikey: YOUR-API-KEY-HERE");
     curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
     const char *data = "{\n    \"PostalCode\": \"<string>\",\n    \"CountryFullName\": \"<string>\",\n    \"CountryCode\": \"<string>\"\n}";
     curl_easy_setopt(curl, CURLOPT_POSTFIELDS, data);
     res = curl_easy_perform(curl);
curl --location --request POST '' \
--header 'Content-Type: application/json' \
--header 'Apikey: YOUR-API-KEY-HERE' \
--data-raw '{
    "PostalCode": "<string>",
    "CountryFullName": "<string>",
    "CountryCode": "<string>"
import Foundation
#if canImport(FoundationNetworking)
import FoundationNetworking

var semaphore = DispatchSemaphore (value: 0)

let parameters = "{\n    \"PostalCode\": \"<string>\",\n    \"CountryFullName\": \"<string>\",\n    \"CountryCode\": \"<string>\"\n}"
let postData = .utf8)

var request = URLRequest(url: URL(string: "")!,timeoutInterval: Double.infinity)
request.addValue("application/json", forHTTPHeaderField: "Content-Type")
request.addValue("YOUR-API-KEY-HERE", forHTTPHeaderField: "Apikey")

request.httpMethod = "POST"
request.httpBody = postData

let task = URLSession.shared.dataTask(with: request) { data, response, error in 
     guard let data = data else {
          print(String(describing: error))
     print(String(data: data, encoding: .utf8)!)


This code snippet uses the built-in JavaScript XHR request capability

var data = JSON.stringify({
     "PostalCode": "<string>",
     "CountryFullName": "<string>",
     "CountryCode": "<string>"

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
     if(this.readyState === 4) {
});"POST", "");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.setRequestHeader("Apikey", "YOUR-API-KEY-HERE");

package main

import (

func main() {

     url := ""
     method := "POST"

     payload := strings.NewReader(`{
    "PostalCode": "<string>",
    "CountryFullName": "<string>",
    "CountryCode": "<string>"

     client := &http.Client {
     req, err := http.NewRequest(method, url, payload)

     if err != nil {
     req.Header.Add("Content-Type", "application/json")
     req.Header.Add("Apikey", "YOUR-API-KEY-HERE")

     res, err := client.Do(req)
     if err != nil {
     defer res.Body.Close()

     body, err := ioutil.ReadAll(res.Body)
     if err != nil {

Walkthrough Video