## Documentation Index

Fetch the complete documentation index at: [/llms.txt](https://developers.dwolla.com/llms.txt)

Use this file to discover all available pages before exploring further.

GET

https://api.dwolla.comhttps://api-sandbox.dwolla.com/beneficial-owners/{id}

#### cURL
```bash
GET https://api-sandbox.dwolla.com/beneficial-owners/976a4c14-b183-40e9-b2df-ddbb3e794d3f
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY
```

#### Examples

```javascript
// Using dwolla-v2 - https://github.com/Dwolla/dwolla-v2-node
var beneficialOwnerUrl = "https://api-sandbox.dwolla.com/beneficial-owners/07d59716-ef22-4fe6-98e8-f3190233dfb8";

dwolla.get(beneficialOwnerUrl).then((res) => res.body.firstName); // => 'Jane'
```

```python
# Using dwollav2 - https://github.com/Dwolla/dwolla-v2-python
beneficial_owner_url = 'https://api-sandbox.dwolla.com/beneficial-owners/07d59716-ef22-4fe6-98e8-f3190233dfB8'

beneficial_owner = app_token.get(beneficial_owner_url)
beneficial_owner.body['firstName']
```

```php
<?php
// Using dwollaswagger - https://github.com/Dwolla/dwolla-swagger-php
$beneficialOwnersApi = new DwollaSwagger\BeneficialownersApi($apiClient);

$beneficialOwnerUrl = 'https://api-sandbox.dwolla.com/beneficial-owners/07d59716-ef22-4fe6-98e8-f3190233dfB8';
$beneficialOwner = $beneficialOwnersApi->getById($beneficialOwnerUrl);
?>
```

```ruby
# Using dwolla_v2 - https://github.com/Dwolla/dwolla-v2-ruby
beneficial_owner_url = 'https://api-sandbox.dwolla.com/beneficial-owners/07d59716-ef22-4fe6-98e8-f3190233dfB8'

beneficial_owner = app_token.get beneficial_owner_url
beneficial_owner.firstName # => "Jane"
```

#### Response Formats

200

404

```json
{
  "_links": {},
  "id": "d3d6b41e-5567-4bc6-9c6e-0efd0a3e647e",
  "firstName": "John",
  "lastName": "Doe",
  "address": {
    "address1": "462 Main Street",
    "city": "Des Moines",
    "country": "USA",
    "stateProvinceRegion": "IA",
    "address2": "Suite 123",
    "address3": "Unit 123",
    "postalCode": "50309"
  },
  "verificationStatus": "verified",
  "created": "2022-07-23T00:18:21.419Z"
}
```

```json
{
  "code": "not_found",
  "message": "not found."
}
```

#### Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

#### Headers

Accept
enum<string>
default:application/vnd.dwolla.v1.hal+json

required

The media type of the response. Must be application/vnd.dwolla.v1.hal+json

Available options:
`application/vnd.dwolla.v1.hal+json`

#### Path Parameters

id
string
required
Beneficial owner unique identifier

#### Response

200

application/vnd.dwolla.v1.hal+json

successful operation

Request body model for a Beneficial Owner

_response links_

object
required
Showchild attributes

_id_

string
required
Example:
`"d3d6b41e-5567-4bc6-9c6e-0efd0a3e647e"`

_first name_

string
required
Example:
`"John"`

_last name_

string
required
Example:
`"Doe"`

_address_

InternationalAddress · object
required
Showchild attributes

_verification status_

enum<string>
required
Available options:
`verified`,
`document`,
`incomplete`

Example:
`"verified"`

_created_

string<date-time>
required
Example:
`"2022-07-23T00:18:21.419Z"`