> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.aventure.vc/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.aventure.vc/_mcp/server.

# List person addresses

GET https://api.aventure.vc/v1/people/{personId}/addresses

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

Reference: https://docs.aventure.vc/api-reference/a-venture-api/person-addresses/list-addresses

## Authentication

- `X-Client-Secret` header (required) — Client secret for read-only service-to-service access (no writes)

## Request

### Path parameters

- `personId` (string, required) — Canonical person UUID

## Response

### 200

OK

- `list of object`
  - `address` (integer, optional, nullable) — Legacy address row identifier
  - `addressLine1` (string, optional, nullable)
  - `addressLine2` (string, optional, nullable)
  - `association` (list of object, optional) — Role-period associations for this physical address
    - `id` (integer, required) — Address association row identifier
    - `isCurrent` (boolean, required) — Whether this role is currently relevant
    - `endDate` (date, optional, nullable) — Last known day this role applied
    - `role` (enum, optional, nullable) — Address association role; null means unclassified
      - Allowed values: `domicile`, `dominant`, `origin`
    - `startDate` (date, optional, nullable) — First known day this role applied
  - `city` (object, optional, nullable) — City reference
    - `name` (string, required) — City name
    - `id` (integer, optional, nullable)
  - `country` (object, optional, nullable) — Country reference
    - `name` (string, required) — Country name
    - `countryCodeChar2` (string, optional, nullable) — Two-letter country code
    - `countryCodeChar3` (string, optional, nullable) — Three-letter country code
    - `id` (integer, optional, nullable)
    - `unRegion` (string, optional, nullable)
    - `unSubregion` (string, optional, nullable)
  - `countryAbbrev` (string, optional, nullable)
  - `createdAt` (datetime, optional, nullable)
  - `fullAddress` (string, optional, nullable) — Single-line formatted address
  - `id` (integer, optional, nullable) — Address record identifier
  - `latitude` (double, optional, nullable)
  - `longitude` (double, optional, nullable)
  - `postalCode` (string, optional, nullable)
  - `state` (object, optional, nullable) — State or region reference
    - `name` (string, required) — State or region name
    - `id` (integer, optional, nullable)
    - `stateAbbrev` (string, optional, nullable) — State or region abbreviation
  - `stateAbbrev` (string, optional, nullable)
  - `street` (string, optional, nullable)
  - `updatedAt` (datetime, optional, nullable)
  - `isCurrent` (boolean, optional, nullable, deprecated) — Deprecated aggregate compatibility flag; true when any association is current
  - `isHq` (boolean, optional, nullable, deprecated) — Deprecated legacy flag marking the headquarters or legal/registered address
  - `isPrimary` (boolean, optional, nullable, deprecated) — Deprecated legacy flag marking the primary display address

## Examples

**Response**

```json
[
  {
    "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
  }
]
```

**SDK Code**

```python
import requests

url = "https://api.aventure.vc/v1/people/personId/addresses"

headers = {"X-Client-Secret": "<apiKey>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.aventure.vc/v1/people/personId/addresses';
const options = {method: 'GET', headers: {'X-Client-Secret': '<apiKey>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aventure.vc/v1/people/personId/addresses"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Client-Secret", "<apiKey>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.aventure.vc/v1/people/personId/addresses")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Client-Secret"] = '<apiKey>'

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.aventure.vc/v1/people/personId/addresses")
  .header("X-Client-Secret", "<apiKey>")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.aventure.vc/v1/people/personId/addresses', [
  'headers' => [
    'X-Client-Secret' => '<apiKey>',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.aventure.vc/v1/people/personId/addresses");
var request = new RestRequest(Method.GET);
request.AddHeader("X-Client-Secret", "<apiKey>");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["X-Client-Secret": "<apiKey>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.aventure.vc/v1/people/personId/addresses")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```