Skip to main content
GET
/
v2
/
addresses
/
parse
curl
curl -i -X GET \
'https://api.goshippo.com/v2/addresses/parse?address=Shippo%20731%20Market%20St%20%23200%2C%20San%20Francisco%2C%20CA%2094103%20US%20shippo%40shippo.com%20%2B1-555-999-8888' \
-H 'Authorization: ShippoToken <API_TOKEN>'
{
  "email": "user@shippo.com",
  "phone": "+1-4155550132",
  "address_line_1": "731 Market Street",
  "address_line_2": "#200",
  "city_locality": "San Francisco",
  "state_province": "CA",
  "postal_code": "94103",
  "country_code": "US"
}

Documentation Index

Fetch the complete documentation index at: https://docs.goshippo.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
default:ShippoToken
required

Enter your shippo token with the ShippoToken prefix.

Example: ShippoToken shippo_live_xxxx

Query Parameters

​
address
string
required
Example:

"Shippo 731 Market St #200, San Francisco, CA 94103 US shippo@shippo.com +1-555-999-8888"

Response

Successful Response

The parsed response of an address.

​
email
string<email> | null
Example:

"user@shippo.com"

​
phone
string | null
Example:

"+1-4155550132"

​
address_line_1
string | null
Example:

"731 Market Street"

​
address_line_2
string | null
Example:

"#200"

​
city_locality
string | null
Example:

"San Francisco"

​
state_province
string | null
Example:

"CA"

​
postal_code
string | null
Example:

"94103"

​
country_code
string | null
Example:

"US"