List person addresses

GET

https://api.aventure.vc/v1/people/:personId/addresses

GET

/v1/people/:personId/addresses

$ curl https://api.aventure.vc/v1/people/personId/addresses \
>      -H "X-Client-Secret: <apiKey>"

1 [
2   {
3     "address": 456,
4     "addressLine1": "string",
5     "addressLine2": "string",
6     "association": [
7       {
8         "id": 123,
9         "isCurrent": true,
10         "endDate": "2023-01-15",
11         "role": "domicile",
12         "startDate": "2023-01-15"
13       }
14     ],
15     "city": {
16       "name": "Boston",
17       "id": 1
18     },
19     "country": {
20       "name": "United States",
21       "countryCodeChar2": "US",
22       "countryCodeChar3": "USA",
23       "id": 1,
24       "unRegion": "string",
25       "unSubregion": "string"
26     },
27     "countryAbbrev": "string",
28     "createdAt": "2024-01-15T09:30:00Z",
29     "fullAddress": "123 Main St, Boston, MA 02110, USA",
30     "id": 123,
31     "latitude": 1.1,
32     "longitude": 1.1,
33     "postalCode": "string",
34     "state": {
35       "name": "Massachusetts",
36       "id": 1,
37       "stateAbbrev": "MA"
38     },
39     "stateAbbrev": "string",
40     "street": "string",
41     "updatedAt": "2024-01-15T09:30:00Z",
42     "isCurrent": true,
43     "isHq": true,
44     "isPrimary": true
45   }
46 ]

Returns physical addresses with all role-period associations for one person.

Authentication

X-Client-Secretstring

Client secret for read-only service-to-service access (no writes)

Path parameters

personIdstringRequiredformat: "uuid"

Canonical person UUID

Response

addressinteger or nullOptional

Legacy address row identifier

addressLine1string or nullOptional

addressLine2string or nullOptional

associationlist of objectsOptional

Role-period associations for this physical address

cityobject or nullOptional

City reference

countryobject or nullOptional

Country reference

countryAbbrevstring or nullOptional

createdAtdatetime or nullOptional

fullAddressstring or nullOptional

Single-line formatted address

idinteger or nullOptional

Address record identifier

latitudedouble or nullOptional

longitudedouble or nullOptional

postalCodestring or nullOptional

stateobject or nullOptional

State or region reference

stateAbbrevstring or nullOptional

streetstring or nullOptional

updatedAtdatetime or nullOptional

isCurrentboolean or nullOptionalDeprecated

Deprecated aggregate compatibility flag; true when any association is current

isHqboolean or nullOptionalDeprecated

Deprecated legacy flag marking the headquarters or legal/registered address

isPrimaryboolean or nullOptionalDeprecated

Deprecated legacy flag marking the primary display address

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

406

Not Acceptable Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error