Validar una dirección
Estandariza una dirección de EE. UU. con USPS y comprueba si es entregable. Se cobra por llamada.
Valida y estandariza una dirección de EE. UU. con USPS sin guardarla.
Además de la dirección estandarizada, devuelve información de entregabilidad: ZIP+4, ruta de reparto (carrier route), confirmación DPV de entregabilidad y si la dirección es residencial —lo que determina el recargo residencial que aplican la mayoría de transportistas.
**Este endpoint se cobra por llamada.** El importe cobrado se devuelve en el campo `billed`. Los resultados en caché se cobran igual que las consultas nuevas. Las peticiones hechas con una API key de **sandbox** son gratuitas y devuelven un resultado simulado.
La validación de direcciones que se realiza automáticamente dentro de `POST /v1/rates` **no** se cobra: solo se cobran las llamadas directas a este endpoint. `POST /v1/addresses/verify` es un alias de este endpoint y se cobra de forma idéntica.
Parámetros
Cuerpo de la petición
street1
string
Obligatorio
Dirección de la calle.
street2
string
Apartamento, suite o unidad. Inclúyelo: el número de unidad forma parte del punto de entrega, y omitirlo puede cambiar si la dirección se considera entregable.
city
string
Obligatorio
Ciudad.
state
string
Obligatorio
Código de estado de 2 letras (p. ej.
CA).zip
string
Obligatorio
ZIP de 5 dígitos o ZIP+4.
country
string
Por defecto
US. Hoy solo direcciones de EE. UU.Devuelve
200
Resultado de la validación. El campo
billed indica el importe cobrado.
400
Datos de dirección inválidos
401
Se requiere autenticación
402
Saldo insuficiente en la cartera: no se devuelve la validación
429
Límite de peticiones superado
Relacionado
addresses
validation
usps
POST/api/v1/addresses/validate