> 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.

# Get person entity association

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

Returns one person-scoped association join row.

Reference: https://docs.aventure.vc/api-reference/a-venture-api/entity-person-associations/get-person-entity-association

## Authentication

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

## Request

### Path parameters

- `personId` (string, required) — Person UUID
- `associationId` (integer, required) — Association id

### Query parameters

- `countOnly` (boolean, optional) — Return count metadata without full content
- `includeUrl` (boolean, optional) — Include entity URL records
- `permitMonogram` (boolean, optional) — Permit generated monogram logo fallback
- `cursor` (string, optional) — Opaque URL-safe cursor token from X-Next-Cursor

## Response

### 200

OK

- `associationId` (integer, required) — Integer person-entity association join row id, not a person or entity UUID
- `entityAddress` (list of object, required) — Entity addresses carried on the association projection
  - `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
- `entityId` (string, required) — Associated entity id
- `entityLogo` (object, required) — Entity logo image projection
  - `isMonogram` (boolean, required) — Whether entity image monogram
  - `logo` (string, optional, nullable)
  - `logoSquare` (string, optional, nullable)
- `entitySlug` (string, required) — Canonical lowercase URL slug for the resource
- `entityUrlLink` (list of object, required) — Entity URL links carried on the association projection
  - `url` (string, required) — Canonical absolute HTTP URL value - validates scheme + host at construction
  - `urlType` (enum, required) — Canonical URL platform type such as website, linkedin, twitter, or github. Lifecycle facts belong on link flags such as isCurrent and isPrimary.
    - Allowed values: `website`, `linkedin`, `twitter`, `github`, `facebook`, `instagram`, `tiktok`, `youtube`, `subreddit`, `forum`, `documentation`, `support`, `statuspage`, `changelog`, `roadmap`, `discord`, `crunchbase`, `wellfound`, `angellist`, `glassdoor`, `theorg`, `ycombinator`, `wikipedia`, `pitchbook`, `morningstar`, `bloomberg`, `nyse`, `nasdaq`, `g2`, `producthunt`, `trustpilot`, `alternativeto`, `gartnerpeerinsights`, `getapp`, `sourceforge`, `appstore`, `googleplay`, `capterra`, `trustradius`, `hubspotmarketplace`, `slackappdirectory`, `awsmarketplace`, `salesforceappexchange`, `chromewebstore`, `vscodemarketplace`, `npm`, `pypi`, `maven`, `dockerhub`, `homebrew`, `crates`
  - `crawlCdnProvider` (enum, optional, nullable) — CDN or hosting provider fronting a web URL.
    - Allowed values: `cloudflare`, `akamai`, `fastly`, `awsCloudfront`, `vercel`, `netlify`, `sucuri`, `incapsula`, `bunny`, `keycdn`, `cdn77`, `gcore`, `cdnetworks`, `azureCdn`, `leaseweb`, `digitalocean`, `stackpath`, `googlecloudCdn`, `none`, `unknown`
  - `crawlRenderMode` (enum, optional, nullable) — JavaScript rendering requirement for crawl checks.
    - Allowed values: `static`, `jsRequired`, `jsEnhanced`
  - `createdAt` (datetime, optional, nullable)
  - `id` (integer, optional, nullable)
  - `isCurrent` (boolean, optional, nullable) — `true` = owner currently uses this URL; `false` = historical/former (rebrand source domain, deprecated platform handle). The lifecycle state lives here, NEVER in the `urlType` discriminator.
  - `isPrimary` (boolean, optional, nullable) — `true` = canonical/primary URL of this `urlType` for this owner. Only one row per (owner, urlType) may be `isCurrent=true` AND `isPrimary=true`.
  - `owner` (object, optional, nullable) — Owning record, nested ids only: owner.entityId or owner.personId — exactly one is set, and no name fields. Writes are scoped by the owning entity/person route; owner is never a write field.
    - `entityId` (string, optional, nullable) — Canonical entity UUID
    - `personId` (string, optional, nullable) — Canonical person UUID
  - `sourceId` (string, optional, nullable)
  - `status` (string, optional, nullable)
  - `statusChecked` (datetime, optional, nullable)
  - `updatedAt` (datetime, optional, nullable)
- `personAddress` (list of object, required) — Person addresses carried on the association projection
  - `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
- `personId` (string, required) — Associated person id
- `personImage` (object, required) — Person image projection
  - `isMonogram` (boolean, required) — Whether person image monogram
  - `picture` (string, optional, nullable)
- `personName` (string, required)
- `personSlug` (string, required) — Canonical lowercase URL slug for the resource
- `personUrlLink` (list of object, required) — Person URL links carried on the association projection
  - `url` (string, required) — Canonical absolute HTTP URL value - validates scheme + host at construction
  - `urlType` (enum, required) — Canonical URL platform type such as website, linkedin, twitter, or github. Lifecycle facts belong on link flags such as isCurrent and isPrimary.
    - Allowed values: `website`, `linkedin`, `twitter`, `github`, `facebook`, `instagram`, `tiktok`, `youtube`, `subreddit`, `forum`, `documentation`, `support`, `statuspage`, `changelog`, `roadmap`, `discord`, `crunchbase`, `wellfound`, `angellist`, `glassdoor`, `theorg`, `ycombinator`, `wikipedia`, `pitchbook`, `morningstar`, `bloomberg`, `nyse`, `nasdaq`, `g2`, `producthunt`, `trustpilot`, `alternativeto`, `gartnerpeerinsights`, `getapp`, `sourceforge`, `appstore`, `googleplay`, `capterra`, `trustradius`, `hubspotmarketplace`, `slackappdirectory`, `awsmarketplace`, `salesforceappexchange`, `chromewebstore`, `vscodemarketplace`, `npm`, `pypi`, `maven`, `dockerhub`, `homebrew`, `crates`
  - `crawlCdnProvider` (enum, optional, nullable) — CDN or hosting provider fronting a web URL.
    - Allowed values: `cloudflare`, `akamai`, `fastly`, `awsCloudfront`, `vercel`, `netlify`, `sucuri`, `incapsula`, `bunny`, `keycdn`, `cdn77`, `gcore`, `cdnetworks`, `azureCdn`, `leaseweb`, `digitalocean`, `stackpath`, `googlecloudCdn`, `none`, `unknown`
  - `crawlRenderMode` (enum, optional, nullable) — JavaScript rendering requirement for crawl checks.
    - Allowed values: `static`, `jsRequired`, `jsEnhanced`
  - `createdAt` (datetime, optional, nullable)
  - `id` (integer, optional, nullable)
  - `isCurrent` (boolean, optional, nullable) — `true` = owner currently uses this URL; `false` = historical/former (rebrand source domain, deprecated platform handle). The lifecycle state lives here, NEVER in the `urlType` discriminator.
  - `isPrimary` (boolean, optional, nullable) — `true` = canonical/primary URL of this `urlType` for this owner. Only one row per (owner, urlType) may be `isCurrent=true` AND `isPrimary=true`.
  - `owner` (object, optional, nullable) — Owning record, nested ids only: owner.entityId or owner.personId — exactly one is set, and no name fields. Writes are scoped by the owning entity/person route; owner is never a write field.
    - `entityId` (string, optional, nullable) — Canonical entity UUID
    - `personId` (string, optional, nullable) — Canonical person UUID
  - `sourceId` (string, optional, nullable)
  - `status` (string, optional, nullable)
  - `statusChecked` (datetime, optional, nullable)
  - `updatedAt` (datetime, optional, nullable)
- `createdAt` (datetime, optional, nullable)
- `creator` (string, optional, nullable) — Association creator label
- `endDate` (datetime, optional, nullable) — Association period end timestamp
- `entityName` (string, optional, nullable)
- `entityOperatingStatus` (string, optional, nullable)
- `entityType` (enum, optional, nullable) — Entity type classification
  - Allowed values: `Company`, `Investment Firm`, `Fund`, `Nonprofit`, `Government`, `Organization`, `Business Line`, `Product`, `Service`
- `isCurrent` (boolean, optional, nullable)
- `score` (integer, optional, nullable)
- `startDate` (datetime, optional, nullable) — Association period start timestamp
- `titleFunction` (string, optional, nullable) — Read-side corporate title function for the association row
- `titleId` (integer, optional, nullable) — Corporate title id for the association row
- `titleLevel` (string, optional, nullable) — Read-side corporate title level for the association row
- `titleName` (string, optional, nullable) — Read-side corporate title text for the association row
- `updatedAt` (datetime, optional, nullable)

## Examples

**Response**

```json
{
  "associationId": 1,
  "entityAddress": [
    {
      "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
    }
  ],
  "entityId": "string",
  "entityLogo": {
    "isMonogram": true,
    "logo": "string",
    "logoSquare": "string"
  },
  "entitySlug": "aventure-vc",
  "entityUrlLink": [
    {
      "url": "https://example.com",
      "urlType": "website",
      "crawlCdnProvider": "cloudflare",
      "crawlRenderMode": "static",
      "createdAt": "2024-01-15T09:30:00Z",
      "id": 1,
      "isCurrent": true,
      "isPrimary": true,
      "owner": {
        "entityId": "string",
        "personId": "string"
      },
      "sourceId": "string",
      "status": "string",
      "statusChecked": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-01-15T09:30:00Z"
    }
  ],
  "personAddress": [
    {
      "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
    }
  ],
  "personId": "string",
  "personImage": {
    "isMonogram": true,
    "picture": "string"
  },
  "personName": "string",
  "personSlug": "aventure-vc",
  "personUrlLink": [
    {
      "url": "https://example.com",
      "urlType": "website",
      "crawlCdnProvider": "cloudflare",
      "crawlRenderMode": "static",
      "createdAt": "2024-01-15T09:30:00Z",
      "id": 1,
      "isCurrent": true,
      "isPrimary": true,
      "owner": {
        "entityId": "string",
        "personId": "string"
      },
      "sourceId": "string",
      "status": "string",
      "statusChecked": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-01-15T09:30:00Z"
    }
  ],
  "createdAt": "2024-01-15T09:30:00Z",
  "creator": "string",
  "endDate": "2024-01-15T09:30:00Z",
  "entityName": "string",
  "entityOperatingStatus": "string",
  "entityType": "Company",
  "isCurrent": true,
  "score": 1,
  "startDate": "2024-01-15T09:30:00Z",
  "titleFunction": "string",
  "titleId": 1,
  "titleLevel": "string",
  "titleName": "string",
  "updatedAt": "2024-01-15T09:30:00Z"
}
```

**SDK Code**

```python
import requests

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

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

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

print(response.json())
```

```javascript
const url = 'https://api.aventure.vc/v1/people/personId/entities/1';
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/entities/1"

	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/entities/1")

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/entities/1")
  .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/entities/1', [
  'headers' => [
    'X-Client-Secret' => '<apiKey>',
  ],
]);

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

```csharp
using RestSharp;

var client = new RestClient("https://api.aventure.vc/v1/people/personId/entities/1");
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/entities/1")! 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()
```