Skip to main content
POST
/
v2
/
naa
Address Normalizer API
curl --request POST \
  --url https://api.cufinder.io/v2/naa \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "address": "<string>"
}
'

​
Common Use Cases

Clean, consistent addresses keep deliveries, billing, and location reporting from breaking down.
  • Data Hygiene: Standardizing messy address records before they enter your CRM or database.
  • Shipping and Logistics: Validating delivery addresses to cut failed deliveries and returns.
  • Deduplication: Matching records that describe the same location written different ways.
  • Billing and Compliance: Keeping customer addresses consistent for invoicing and tax.
  • Analytics: Cleaning location data so regional reports and maps stay accurate.
Credit usage is 1 per record found.

​
Attributes

​
address
string
required
Optional Address

​
Response

{
    "status": 1,
    "data": {
        "confidence_level": 98,
        "query": "5340 alla rd, los angeles, ca 90066, united states",
        "address": "5340 ALLA RD LOS ANGELES CA 90066 UNITED STATES",
        "credit_count": 21
    }
}

​
Address Normalizer API Typescript SDK

import { Cufinder } from '@cufinder/cufinder-ts';

// Initialize the client
const client = new Cufinder('your-api-key-here');

// Initialize with more options
const client = new Cufinder('your-api-key-here', { timeout: 60000 });

const result = await client.naa('1095 avenue of the Americas, 6th Avenue ny 10036')
console.log(result);

​
Address Normalizer API Python SDK

from cufinder import Cufinder

# Initialize the client
client = Cufinder('your-api-key-here')

# Initialize with more options
client = Cufinder('your-api-key-here', timeout=60)

result = client.naa('1095 avenue of the Americas, 6th Avenue ny 10036')
print(result)

​
Address Normalizer API Go SDK

package main

import (
    "fmt"
    "log"
    
    "github.com/cufinder/cufinder-go"
)

func main() {
    // Initialize the client
    sdk := cufinder.NewSDK("your-api-key-here")
    
    // Initialize with more options
    sdk := cufinder.NewSDKWithConfig(cufinder.ClientConfig{
        APIKey:     "your-api-key-here",
        BaseURL:    "https://api.cufinder.io/v2",
        Timeout:    60 * time.Second,
        MaxRetries: 3,
    })
}
result, err := sdk.NAA("1095 avenue of the Americas, 6th Avenue ny 10036")
if err != nil {
    log.Fatal(err)
}
fmt.Println(result)

​
Address Normalizer API Ruby SDK

require 'cufinder_ruby'

# Initialize the client
client = Cufinder::Client.new(api_key: 'your-api-key-here')

# Initialize with more options
client = Cufinder::Client.new(
    api_key: 'your-api-key-here',
    timeout: 60,
    max_retries: 3
)

result = client.naa(address: "1095 avenue of the Americas, 6th Avenue ny 10036")
puts result

​
Address Normalizer API Rust SDK

use cufinder_rust::CufinderSDK;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Initialize the client
    let sdk = CufinderSDK::new("your-api-key-here".to_string())?;
    
    // Initialize with more options
    let sdk = CufinderSDK::with_config(ClientConfig {
        api_key: "your-api-key-here".to_string(),
        base_url: "https://api.cufinder.io/v2".to_string(),
        timeout: Duration::from_secs(60),
        max_retries: 3,
    })?;
    
    Ok(())
}

let result = sdk.naa("1095 avenue of the Americas, 6th Avenue ny 10036").await?;
println!("{:?}", result);

Phone Number Normalizer

Standardize phone numbers to a clean format.

Company Normalizer

Clean and standardize company names.

Company Locations

List a company’s office locations.

Company Enrichment

Enrich a company with full firmographics.