Get Associated Person

curl --request GET \
  --url https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/associated-persons/{ap_id} \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/associated-persons/{ap_id}"

headers = {"X-API-Key": "<api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/associated-persons/{ap_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/associated-persons/{ap_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/associated-persons/{ap_id}"

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

	req.Header.Add("X-API-Key", "<api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/associated-persons/{ap_id}")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/associated-persons/{ap_id}")

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

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

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

{
  "object": "associated_person",
  "id": "aap_8rty2c1x7k2m9p4q1w8e5r3t",
  "account_id": "acct_3mnq7c1e6a2b4f3c9b8d2e5a",
  "role": "director",
  "is_signer": false,
  "first_name": "John",
  "middle_name": "Q",
  "last_name": "Public",
  "email": "john@acme.example",
  "phone_number": null,
  "date_of_birth": "1979-11-02",
  "country_code": "SG",
  "nationality": "SG",
  "ownership_percentage": null,
  "residential_address": {
    "address_line": "10 Marina Blvd",
    "city": "Singapore",
    "region": "Singapore",
    "postal_code": "018983",
    "country": "SG"
  },
  "verification_status": "approved",
  "rejection_reasons": [],
  "created": "2026-05-30T12:00:00Z",
  "updated": "2026-06-02T08:15:00Z",
  "created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
  "updated_by": null
}

GET

ads

customers

{customer_id}

accounts

{account_id}

associated-persons

{ap_id}

Get Associated Person

curl --request GET \
  --url https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/associated-persons/{ap_id} \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/associated-persons/{ap_id}"

headers = {"X-API-Key": "<api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/associated-persons/{ap_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/associated-persons/{ap_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/associated-persons/{ap_id}"

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

	req.Header.Add("X-API-Key", "<api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/associated-persons/{ap_id}")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/associated-persons/{ap_id}")

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

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

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

{
  "object": "associated_person",
  "id": "aap_8rty2c1x7k2m9p4q1w8e5r3t",
  "account_id": "acct_3mnq7c1e6a2b4f3c9b8d2e5a",
  "role": "director",
  "is_signer": false,
  "first_name": "John",
  "middle_name": "Q",
  "last_name": "Public",
  "email": "john@acme.example",
  "phone_number": null,
  "date_of_birth": "1979-11-02",
  "country_code": "SG",
  "nationality": "SG",
  "ownership_percentage": null,
  "residential_address": {
    "address_line": "10 Marina Blvd",
    "city": "Singapore",
    "region": "Singapore",
    "postal_code": "018983",
    "country": "SG"
  },
  "verification_status": "approved",
  "rejection_reasons": [],
  "created": "2026-05-30T12:00:00Z",
  "updated": "2026-06-02T08:15:00Z",
  "created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
  "updated_by": null
}

Fetches a single associated person by id. The person must belong to the given account, otherwise the request fails with 404. There is no request body.

Path Parameters

string

required

Id of the Platform customer.

string

required

Id of the parent account.

string

required

Id of the associated person (e.g. aap_…).

Response

Returns 200 with the associated-person object. rejection_reasons is a list of { reason, developer_reason } objects and defaults to [].

string

Always "associated_person".

string

Id of the associated person (e.g. aap_…).

string

Id of the parent account.

enum

One of ultimate_beneficial_owner, director, control_person.

boolean

Whether this person is an authorized signer for the entity.

string

Given name.

string | null

Middle name, if any.

string

Family name.

Contact email address of the person.

string | null

Contact phone number.

date

Date of birth, ISO 8601 (YYYY-MM-DD).

string

Country of residence, ISO 3166-1 alpha-2.

string

Nationality, ISO 3166-1 alpha-2.

decimal | null

Ownership stake, if any.

Address

Residential address of the person.

Show child attributes

string

Street address line.

string

City.

string

State / province / region.

string

Postal code.

string

Country code string (ISO 3166-1 alpha-2).

enum

One of under_review, approved, rejected.

array

List of { reason, developer_reason } objects. Defaults to [].

string

ISO 8601 timestamp when created.

string | null

ISO 8601 timestamp when last updated.

string

Id of the API key that created the person.

string | null

Id of the API key that last updated the person.

{
  "object": "associated_person",
  "id": "aap_8rty2c1x7k2m9p4q1w8e5r3t",
  "account_id": "acct_3mnq7c1e6a2b4f3c9b8d2e5a",
  "role": "director",
  "is_signer": false,
  "first_name": "John",
  "middle_name": "Q",
  "last_name": "Public",
  "email": "john@acme.example",
  "phone_number": null,
  "date_of_birth": "1979-11-02",
  "country_code": "SG",
  "nationality": "SG",
  "ownership_percentage": null,
  "residential_address": {
    "address_line": "10 Marina Blvd",
    "city": "Singapore",
    "region": "Singapore",
    "postal_code": "018983",
    "country": "SG"
  },
  "verification_status": "approved",
  "rejection_reasons": [],
  "created": "2026-05-30T12:00:00Z",
  "updated": "2026-06-02T08:15:00Z",
  "created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
  "updated_by": null
}

List Associated Persons Update Associated Person

Getting Started

Integration Flows

Webhooks

Endpoints

Get Associated Person

Path Parameters

Response

​Path Parameters

​Response

Path Parameters

Response