1.0.1 • Published 6 months ago

@evokegroup/usps v1.0.1

Weekly downloads
-
License
ISC
Repository
-
Last release
6 months ago

@evokegroup/usps

Library for validating address information with USPS

UspsClient

constructor()

ParameterTypeDefaultDescription
apiUserIDstring
apiUrlstringhttps://production.shippingapis.com/ShippingAPI.dll

Methods

validateAddress()

ParameterTypeDefaultDescription
address1string
address2string
citystring
statestring
zip5string
zip4string

returns Promise<ValidateResponse>

import { UpspClient } from '@evokegroup/usps';

const usps = new UspsClient('XXXXXXXXXX');
usps.validateAddress({
  address1: '123 Main St',
  city: 'Anytown',
  state: 'ST',
  zip5: '12345'
})
  .then((validateResponse) => {
    // do something
  })
  .catch((err) => {
    // handle error
  });

cityStateLookup()

ParameterTypeDefaultDescription
zip5string

returns Promise<Response>

import { UpspClient } from '@evokegroup/usps';

const usps = new UspsClient('XXXXXXXXXX');
usps.cityStateLookup('12345')
  .then((Response) => {
    // do something
  })
  .catch((err) => {
    // handle error
  });

zipCodeLookup()

ParameterTypeDefaultDescription
address1string
citystring
statestring

returns Promise<Response>

import { UpspClient } from '@evokegroup/usps';

const usps = new UspsClient('XXXXXXXXXX');
usps.zipCodeLookup({
  address1: '123 Main St',
  city: 'Anytown',
  state: 'ST'
})
  .then((Response) => {
    // do something
  })
  .catch((err) => {
    // handle error
  });

Response

NameTypeDescription
foundboolean
statusStatus
addressAddress
errorstring

ValidateResponse

extends Response

NameTypeDescription
matchAddressMatch
exactMatchboolean

Address

NameTypeDescription
address1string
address2string
citystring
statestring
zip5string
zip4string

AddressMatch

NameTypeDescription
address1boolean
address2boolean
cityboolean
stateboolean
zip5boolean
zip4boolean

Status

'FOUND' | 'ADDRESS_NOT_FOUND' | 'INVALID_CITY' | 'INVALID_STATE' | 'INVALID_ZIP_CODE' | 'ERROR'

1.0.1

6 months ago

1.0.0

6 months ago