---
title: "HalOwners"
canonical: "https://openfinanceguide.com/en/stet/1.6.3/resources/hal-owners"
edition: "STET PSD2 API 1.6.3.1"
source: "https://openfinanceguide.com/docs/stet/1.6.3/pdf/api-dsp2-stet-v1.6.3.2-openapi.yaml"
pdf: "https://openfinanceguide.com/docs/stet/1.6.3/pdf/api-dsp2-stet-v1.6.3.1-part-2-functional-model.pdf"
language: "en"
normative: "The normative text is the English PDF and OpenAPI file published by STET. This Markdown reproduces it for reading; where they differ, the PDF prevails."
license: "CC BY 3.0 FR (https://creativecommons.org/licenses/by/3.0/fr/), STET. Converted to Markdown by Open Finance Guide."
---

# HalOwners

Type: `object` · Kind: Hal

HYPERMEDIA structure used for returning the identities of the account owners.
These owners are either real persons or a company.
- in the first case, the [identities] block must be used
- in the second cas, the [company] property specifies the identity of the company owning the account.

Fields:

- `company`, [`GenericIdentification`](https://openfinanceguide.com/raw/stet/1.6.3/en/resources/generic-identification.md)
- `identities`, array of [`Identity`](https://openfinanceguide.com/raw/stet/1.6.3/en/resources/identity.md) — identity of the account owners.
- `_links`, [`OwnersLinks`](https://openfinanceguide.com/raw/stet/1.6.3/en/resources/owners-links.md), required

## Example

```json
{
  "identities": [
    {
      "fullName": "M. John Doe",
      "namePrefix": "MIST",
      "firstName": "John",
      "lastName": "Doe"
    }
  ],
  "_links": {
    "balances": {
      "href": "/v1/accounts/Alias1/balances"
    },
    "transactions": {
      "href": "/v1/accounts/Alias1/transactions"
    },
    "overdrafts": {
      "href": "/v1/accounts/Alias1/overdrafts"
    }
  }
}
```

## Used by

- `GET /accounts/{accountResourceId}/owners` (accountsOwnersGet)