Checking authentication...

Address

Verify, geocode, reverse geocode, and autocomplete addresses

4 tools

Verify Address

Write Idempotent

POST /v1/tools/batchdata/verifyAddress

Verify and normalize a US street address using USPS standards. Returns standardized address, deliverability status, and coordinates.

Parameters

Name	Type	Required	Description
`street`	string	required	Street address
`city`	string	required	City name
`state`	string	required	Two-letter state code
`zip`	string	optional	ZIP code (optional, improves accuracy)

Request

curl -X POST https://api.syncello.io/v1/tools/batchdata/verifyAddress \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "street": "example",
  "city": "example",
  "state": "example"
}'

Response

{
  "results": {
    "addresses": [
      {
        "hash": "a1b2c3d4e5f6a7b8",
        "houseNumber": "500",
        "utcOffset": -7,
        "vacant": "N",
        "longitude": -104.9903,
        "daylightSavingsTime": true,
        "dpvFootnotes": "AABB",
        "street": "500 Commerce Blvd",
        "latitude": 39.7392,
        "city": "Denver",
        "zipPlus4": "1234",
        "geoLocation": [
          -104.9903,
          39.7392
        ],
        "county": "Denver",
        "state": "CO",
        "countyFipsCode": "08031",
        "carrierRoute": "C012",
        "error": "",
        "footnotes": "N#",
        "unitType": "",
        "unitNumber": "",
        "formattedStreet": "500 Commerce Blvd",
        "streetNoUnit": "500 Commerce Blvd",
        "timeZone": "America/Denver",
        "meta": {
          "verified": true,
          "normalized": true,
          "hashed": true,
          "error": false
        },
        "request": {
          "state": "CO",
          "street": "500 Commerce Blvd",
          "zip": "80202",
          "city": "Denver",
          "requestId": "req_addr_0"
        },
        "zip": "80202",
        "congressionalDistrict": "01",
        "requestId": 0,
        "dpvMatchCode": "Y"
      }
    ],
    "meta": {
      "apiVersion": "v1",
      "performance": {
        "endTime": "2026-07-02T21:00:00.500Z",
        "startTime": "2026-07-02T21:00:00.000Z",
        "totalRequestTime": 480
      },
      "requestId": "a1f4c9e2b7d3",
      "results": {
        "errorCount": 0,
        "hashedCount": 1,
        "normalizedCount": 1,
        "notHashedCount": 0,
        "notNormalizedCount": 0,
        "requestCount": 1
      }
    }
  },
  "status": {
    "code": 200,
    "text": "OK"
  }
}

Try It

Try it

Geocode Address

Write Idempotent

POST /v1/tools/batchdata/geocodeAddress

Convert a street address to latitude/longitude coordinates (geocoding).

Parameters

Name	Type	Required	Description
`address`	string	required	Full address string (e.g., "123 Main St, Phoenix, AZ 85001")

Request

curl -X POST https://api.syncello.io/v1/tools/batchdata/geocodeAddress \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "address": "example"
}'

Response

{
  "result": {
    "addresses": [
      {
        "houseNumber": "123",
        "city": "Phoenix",
        "zip": "85001",
        "geoLocation": [
          -112.074,
          33.4484
        ],
        "meta": {
          "geocoded": true,
          "error": false
        },
        "county": "Maricopa",
        "street": "123 Main St",
        "streetNoUnit": "123 Main St",
        "geoStatus": "rooftop",
        "longitude": -112.074,
        "request": {
          "requestId": "req_geo_0",
          "address": "123 Main St, Phoenix, AZ 85001"
        },
        "state": "AZ",
        "fullAddress": "123 Main St, Phoenix, AZ 85001",
        "latitude": 33.4484,
        "formattedStreet": "123 Main St"
      }
    ],
    "meta": {
      "apiVersion": "v1",
      "errorCount": 0,
      "matchCount": 1,
      "noMatchCount": 0,
      "performance": {
        "endTime": "2026-07-02T21:00:00.300Z",
        "startTime": "2026-07-02T21:00:00.000Z",
        "totalRequestTime": 300
      },
      "requestCount": 1,
      "requestId": "b7d3a1f4c9e2"
    }
  },
  "status": {
    "code": 200,
    "text": "OK"
  }
}

Try It

Try it

Reverse Geocode Address

Write Idempotent

POST /v1/tools/batchdata/reverseGeocodeAddress

Convert latitude/longitude coordinates to a street address (reverse geocoding).

Parameters

Name	Type	Required	Description
`latitude`	number	required	Latitude coordinate
`longitude`	number	required	Longitude coordinate

Request

curl -X POST https://api.syncello.io/v1/tools/batchdata/reverseGeocodeAddress \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "latitude": "123",
  "longitude": "123"
}'

Response

{
  "result": {
    "addressMeta": {
      "error": false
    },
    "addresses": [
      {
        "geoLocation": [
          -112.074,
          33.4484
        ],
        "formattedStreet": "123 Main St",
        "geoStatus": "rooftop",
        "types": [
          "street_address",
          "premise",
          "geocode",
          "establishment",
          "point_of_interest"
        ],
        "zip": "85001",
        "county": "Maricopa",
        "streetNoUnit": "123 Main St",
        "street": "123 Main St",
        "meta": {
          "error": false
        },
        "state": "AZ",
        "latitude": 33.4484,
        "longitude": -112.074,
        "city": "Phoenix"
      }
    ],
    "meta": {
      "apiVersion": "v1",
      "performance": {
        "endTime": "2026-07-02T21:00:00.250Z",
        "startTime": "2026-07-02T21:00:00.000Z",
        "totalRequestTime": 250
      },
      "requestId": "c9e2b7d3a1f4"
    },
    "request": {
      "latitude": 33.4484,
      "longitude": -112.074
    }
  },
  "status": {
    "code": 200,
    "text": "OK"
  }
}

Try It

Try it

Autocomplete Address

Write Idempotent

POST /v1/tools/batchdata/autocompleteAddress

Get address autocomplete suggestions as the user types. Returns matching addresses with property IDs.

Parameters

Name	Type	Required	Description
`query`	string	required	Partial address to autocomplete (e.g., "123 Main")
`take`	number	optional	Number of suggestions to return (default: 10)

Request

curl -X POST https://api.syncello.io/v1/tools/batchdata/autocompleteAddress \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "query": "example"
}'

Response

{
  "result": {
    "meta": {
      "apiVersion": "v1",
      "performance": {
        "endTime": "2026-07-02T21:00:00.200Z",
        "startTime": "2026-07-02T21:00:00.000Z",
        "totalRequestTime": 200
      },
      "requestId": "d1f4c9e2b7d3",
      "results": {
        "aggComparablesMetrics": {
          "averagePrice": 0,
          "averagePricePerSqft": 0,
          "estimatedValue": 0
        },
        "resultCount": 2,
        "resultsFound": 2,
        "skipTraceErrorCount": 0,
        "skipTraceMatchCount": 0,
        "skipTraceNoMatchCount": 0,
        "skipTraceRequestCount": 0
      }
    },
    "options": {
      "skip": 0,
      "suggestionTypes": [
        "address",
        "street"
      ],
      "take": 3,
      "uspsVerifiedAddresses": false
    },
    "suggestions": [
      {
        "city": "Phoenix",
        "address": "123 Main St",
        "latitude": 33.4484,
        "type": "address",
        "uspsVerified": true,
        "propertyId": "P-10000001",
        "linkedEntityId": "E-20000001",
        "cityAlias": "Phoenix",
        "propertyCount": 1,
        "state": "AZ",
        "zip": "85001",
        "county": "Maricopa",
        "longitude": -112.074,
        "locality": "Phoenix",
        "name": "123 Main St, Phoenix, AZ 85001"
      },
      {
        "city": "Phoenix",
        "address": "123 Main Ave",
        "latitude": 33.4501,
        "type": "address",
        "uspsVerified": true,
        "propertyId": "P-10000002",
        "linkedEntityId": "E-20000002",
        "cityAlias": "Phoenix",
        "propertyCount": 1,
        "state": "AZ",
        "zip": "85003",
        "county": "Maricopa",
        "longitude": -112.0712,
        "locality": "Phoenix",
        "name": "123 Main Ave, Phoenix, AZ 85003"
      }
    ]
  },
  "status": {
    "code": 200,
    "text": "OK"
  }
}