Skip to main content
GET
/
public
/
people
/
{ContactId}
/
location
curl -i -X GET \
  'https://api.portal.io/public/people/1042/location?PageNumber=1&PageSize=10' \
  -H 'Accept: application/json' \
  -H 'X-MSS-API-APPID: YOUR_APP_ID' \
  -H 'X-MSS-API-USERKEY: YOUR_USER_KEY' \
  -H 'X-MSS-CUSTOM-DATE: Mon, 06 Apr 2026 00:22:19 GMT' \
  -H 'X-MSS-SIGNATURE: BASE64_SIGNATURE'

{
  "contactLocations": [
    {
      "contactFirstName": "Jane",
      "contactLastName": "Smith",
      "contactPhoneNumber": "555-555-0100",
      "contactEmail": "jane.smith@example.com",
      "isPrimary": true,
      "isBilling": false,
      "id": 201,
      "street": "123 Main St",
      "suite": "",
      "city": "Austin",
      "postalCode": "78701",
      "state": "Texas",
      "stateAbbrev": "TX",
      "country": "United States",
      "phone": "555-555-0100"
    }
  ],
  "locationCount": 1
}
Retrieves all addresses stored for a specific contact. Results are ordered with the primary location first, the billing location second, and then the remaining locations sorted by most recently modified. Pagination defaults to page 1 with 10 results per page. PageNumber must be 1 or greater — values less than 1 return a 400 error. 
curl -i -X GET \
  'https://api.portal.io/public/people/1042/location?PageNumber=1&PageSize=10' \
  -H 'Accept: application/json' \
  -H 'X-MSS-API-APPID: YOUR_APP_ID' \
  -H 'X-MSS-API-USERKEY: YOUR_USER_KEY' \
  -H 'X-MSS-CUSTOM-DATE: Mon, 06 Apr 2026 00:22:19 GMT' \
  -H 'X-MSS-SIGNATURE: BASE64_SIGNATURE'

{
  "contactLocations": [
    {
      "contactFirstName": "Jane",
      "contactLastName": "Smith",
      "contactPhoneNumber": "555-555-0100",
      "contactEmail": "jane.smith@example.com",
      "isPrimary": true,
      "isBilling": false,
      "id": 201,
      "street": "123 Main St",
      "suite": "",
      "city": "Austin",
      "postalCode": "78701",
      "state": "Texas",
      "stateAbbrev": "TX",
      "country": "United States",
      "phone": "555-555-0100"
    }
  ],
  "locationCount": 1
}

Headers

​
Accept
enum<string>
required

Accept Header

Available options:
application/json
​
X-MSS-API-APPID
string
required

Application Id

​
X-MSS-CUSTOM-DATE
string
required

A date timestamp of the request

​
X-MSS-SIGNATURE
string
required

A signature for the request

​
X-MSS-API-USERKEY
string
required

User API Key

Path Parameters

​
ContactId
integer<int32>
required

Query Parameters

​
PageNumber
integer<int32>
​
PageSize
integer<int32>

Response

Success

Contact-location list response

​
locationCount
integer<int32>
required

Total number of locations matching the current request

​
contactLocations
PublicContactLocationModel · object[]

Locations returned for the requested contact