---
title: "List owners"
method: GET
path: "/processing-accounts/{processingAccountId}/owners"
tags: ["processingAccounts"]
---

# List owners

`GET /processing-accounts/{processingAccountId}/owners`

Use this method to return a list of owners of a processing account.  

**Note:** If you want to view the details of a specific owner and you have the ownerId, go to our [Retrieve Owner](https://docs.payroc.com/api/schema/boarding/owners/retrieve) method.  

To list the owners of a processing account, you need its processingAccountId. If you don't have the processingAccountId, use our [List Merchant Platform's Processing Accounts](https://docs.payroc.com/api/schema/boarding/merchant-platforms/list-processing-accounts) method to search for the processing account.  

Our gateway returns the following information about each owner in the list: 

- Name, date of birth, and address.  
- Contact details, including their email address.  
- Relationship to the business, including whether they are a control prong or authorized signatory, and their equity stake in the business.

## Path parameters

- `processingAccountId` string, required

## Query parameters

- `before` string
- `after` string
- `limit` integer

## Headers

- `Authorization` string, required

## Response `200`

Successful request. Returns a list of owners associated with the processing account.

- PaginatedOwners — Contains the pagination properties that you use to navigate through a list of results.
  - `limit` integer — Maximum number of results that we return for each page.
  - `count` integer — Number of results we returned on this page. **Note:** This might not be the total number of results that match your query.
  - `hasMore` boolean — Indicates whether there is another page of results available.
  - `links` Link[] — Reference links to navigate to the previous page of results or to the next page of results.
    - `rel` string, required — Indicates the relationship between the current resource and the target resource.
    - `method` string, required — HTTP method that you need to use with the target resource.
    - `href` string, required — URL of the target resource.
  - `data` Owner[] — Array of owner objects.
    - `ownerId` integer — Unique identifier that we assigned to the owner.
    - `firstName` string, required — Owner's first name.
    - `middleName` string — Owner's middle name.
    - `lastName` string, required — Owner's last name.
    - `dateOfBirth` string, date, required — Owner's date of birth. The format of this value is **YYYY-MM-DD**.
    - `address` Address, required — Object that contains information about the address.
      - `address1` string, required — Address line 1.
      - `address2` string — Address line 2.
      - `address3` string — Address line 3.
      - `city` string, required — City.
      - `state` string, required — Name of the state or state abbreviation.
      - `country` string, required — Two-digit country code for the country that the business operates in. The format follows the [ISO-3166-1](https://www.iso.org/iso-3166-country-codes.html) standard.
      - `postalCode` string, required — Zip code or postal code.
    - `identifiers` Identifier[], required — Array of IDs.
      - `type` 'nationalId', required — Type of ID provided to verify identity.
      - `value` string, required — Social Security Number (SSN) or Social Insurance Number (SIN).
    - `contactMethods` ContactMethod[], required — Array of polymorphic objects, which contain contact information. **Note:** If you are adding information about an owner, you must provide at least an email address. If you are adding information about a contact, you must provide at least a contact number. The value of the type parameter determines which variant you should use: - `email` - Email address - `phone` - Phone number - `mobile` - Mobile number - `fax` - Fax number
      - union
        - object — email variant
          - `type` 'email', required — Discriminator value: email
          - `value` string, required — Email address.
        - object — phone variant
          - `type` 'phone', required — Discriminator value: phone
          - `value` string, required — Phone number.
        - object — mobile variant
          - `type` 'mobile', required — Discriminator value: mobile
          - `value` string, required — Mobile number.
        - object — fax variant
          - `type` 'fax', required — Discriminator value: fax
          - `value` string, required — Fax number.
    - `relationship` OwnerRelationship, required — Object that contains information about the owner's relationship to the business.
      - `equityPercentage` number, double — Percentage equity stake that the owner holds in the business.
      - `title` string — Owner's job title.
      - `isControlProng` boolean, required — Indicates if the owner is a control prong. You can identify only one control prong for a business.
      - `isAuthorizedSignatory` boolean — Indicates if the owner is an authorized signatory.

## Other responses

- `400` — Invalid request
- `401` — Identity could not be verified
- `404` — Resource not found
- `406` — Not acceptable
- `500` — An error has occured

---

[API](https://skmtc.dev/payroc/apis/schema.md) · [All operations](https://skmtc.dev/payroc/apis/schema/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/payroc/schema/revisions/1d9d3e305945/schema)