List a Person's 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 "Authorization: Bearer <token>"

[
  {
    "address": 456,
    "addressLine1": "string",
    "addressLine2": "string",
    "association": [
      {
        "id": 123,
        "isCurrent": true,
        "endDate": "2023-01-15",
        "role": "domicile",
        "startDate": "2023-01-15"
      }
    ],
    "city": {
      "name": "Boston",
      "id": 1
    },
    "country": {
      "name": "United States",
      "countryCodeChar2": "US",
      "countryCodeChar3": "USA",
      "id": 1,
      "unRegion": "string",
      "unSubregion": "string"
    },
    "countryAbbrev": "string",
    "createdAt": "2024-01-15T09:30:00Z",
    "fullAddress": "123 Main St, Boston, MA 02110, USA",
    "id": 123,
    "latitude": 1.1,
    "longitude": 1.1,
    "postalCode": "string",
    "state": {
      "name": "Massachusetts",
      "id": 1,
      "stateAbbrev": "MA"
    },
    "stateAbbrev": "string",
    "street": "string",
    "updatedAt": "2024-01-15T09:30:00Z",
    "isCurrent": true,
    "isHq": true,
    "isPrimary": true
  }
]

Returns the person's physical addresses, each with every role it has held for them and the dates of each role.

Authentication

AuthorizationBearer

Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token

Path parameters

personIdstringRequiredformat: "uuid"

Person id (UUID).

Response headers

X-RateLimit-LimitintegerOptional

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-RemainingintegerOptional

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-ResetintegerOptional

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

addressinteger or nullOptional

Legacy address row identifier

addressLine1string or nullOptional

Canonical street address line.

addressLine2string or nullOptional

Canonical suite, floor, or secondary address line.

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

Id of this listed row’s first association; PATCH and DELETE address one association by its association[].id, so a row holding several roles needs one call each

latitudedouble or nullOptional

longitudedouble or nullOptional

postalCodestring or nullOptional

Canonical postal or ZIP code.

stateobject or nullOptional

State or region reference

stateAbbrevstring or nullOptional

Canonical state or region abbreviation.

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 current legal/registered seat (domicile), not the operating HQ; it retires on 2027-02-05. Read a current association[].role of domicile for the legal seat, and match enrichment.headquartersAddressId to enrichment.address[].id for the operating headquarters.

isPrimaryboolean or nullOptionalDeprecated

Deprecated legacy flag marking the current operating headquarters (dominant); it retires on 2027-02-05. Match enrichment.headquartersAddressId to enrichment.address[].id, or read a current association[].role of dominant.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

406

Not Acceptable Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error