Get ultimate beneficial owner by ID
GEThttps://api.publicsquare.com/business/ultimate-beneficial-owners/:id
Get a business ultimate beneficial owner by ID in the Account.
Permissions
business:read
Request
Path Parameters
id stringrequired
Responses
- 200
- 400
- 401
- 403
- 404
OK
- application/json
- Schema
- Example (auto)
Schema
idstringnullable
Ultimate beneficial owner ID
Example:
ubo_5mQSxcSAW3UZ4ijLzEt4RuAib
account_idstringnullable
Account ID
Example:
acc_B518niGwGYKzig6vtrRVZGGGV
government_identifier_last4stringnullable
Last 4 of SSN or personal identifier
Example:
8024
created_atdate-timenullable
Date owner was created
Example:
2024-06-30T01:02:29.212Z
modified_atdate-timenullable
Date owner was modified
Example:
2024-06-30T01:02:29.212Z
titlestringrequired
Job title
Possible values: non-empty
and <= 100 characters
Example:
CEO
first_namestringrequired
First name
Possible values: non-empty
and <= 100 characters
Example:
John
last_namestringrequired
Last name
Possible values: non-empty
and <= 100 characters
Example:
Smith
percent_ownershipdoublerequired
Percentage ownership in business of at least 25% or greater
Example:
33
government_identifierstringnullable
SSN or personal identifier
Example:
483-97-8024
emailemailrequired
Email address
Possible values: non-empty
and <= 250 characters
Example:
john.smith@email.com
phonestringrequired
Phone number
Possible values: non-empty
and <= 50 characters
Example:
+15554879043
date_of_birthdate-timerequired
Date of birth
Example:
1980-11-15
is_politically_exposed_personbooleanrequired
Are they a politically exposed person?
Example:
false
address objectrequired
{
"id": "ubo_5mQSxcSAW3UZ4ijLzEt4RuAib",
"account_id": "acc_B518niGwGYKzig6vtrRVZGGGV",
"government_identifier_last4": "8024",
"created_at": "2024-06-30T01:02:29.212Z",
"modified_at": "2024-06-30T01:02:29.212Z",
"title": "CEO",
"first_name": "John",
"last_name": "Smith",
"percent_ownership": 33,
"government_identifier": "483-97-8024",
"email": "john.smith@email.com",
"phone": "+15554879043",
"date_of_birth": "1980-11-15",
"is_politically_exposed_person": false,
"address": {
"address_line_1": "111 Colorado Ave.",
"address_line_2": "Apt 403",
"city": "Des Moines",
"state": "IA",
"postal_code": "51111",
"country": "US"
}
}
Bad Request
- application/json
- Schema
- Example (auto)
Schema
errors objectnullable
typestringnullable
titlestringnullable
statusint32nullable
detailstringnullable
instancestringnullable
property name*any
{
"errors": {},
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string"
}
Unauthorized
- application/json
- Schema
- Example (auto)
Schema
typestringnullable
titlestringnullable
statusint32nullable
detailstringnullable
instancestringnullable
property name*any
{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string"
}
Forbidden
- application/json
- Schema
- Example (auto)
Schema
typestringnullable
titlestringnullable
statusint32nullable
detailstringnullable
instancestringnullable
property name*any
{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string"
}
Not Found
- application/json
- Schema
- Example (auto)
Schema
typestringnullable
titlestringnullable
statusint32nullable
detailstringnullable
instancestringnullable
property name*any
{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string"
}
Authorization: X-API-KEY
name: X-API-KEYtype: apiKeyscopes: business:read
description: Authorization by API Key inside request's X-API-KEY headerin: header
- csharp
- curl
- dart
- go
- http
- java
- javascript
- kotlin
- c
- nodejs
- objective-c
- ocaml
- php
- powershell
- python
- r
- ruby
- rust
- shell
- swift
- HTTPCLIENT
- RESTSHARP
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://api.publicsquare.com/business/ultimate-beneficial-owners/:id");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("X-API-KEY", "<X-API-KEY>");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
ResponseClear