---
title: "Get Parties for an AccountId"
method: GET
path: "/accounts/{AccountId}/parties"
tags: ["Parties"]
---

# Get Parties for an AccountId

`GET /accounts/{AccountId}/parties`

## Request

- Base URL: `/open-banking/v4.0/aisp` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/open-banking/v4.0/aisp/accounts/{AccountId}/parties`
- Auth: OAuth 2
  - Authorization code: `https://authserver.example/authorization`
  - Token URL: `https://authserver.example/token` scopes: `accounts`

Enables an AISP to retrieve details about the PSU account-holder(s)/operator(s).

## Path parameters

- `AccountId` string, required

## Headers

- `x-fapi-auth-date` string
- `x-fapi-customer-ip-address` string
- `x-fapi-interaction-id` string
- `Authorization` string, required
- `x-customer-user-agent` string
- `x-client-id` string

## Response `200`

Parties Read

- OBReadParty3
  - `Data` object, required
    - `Party` OBParty2[]
      - `PartyId` string, required: A unique and immutable identifier used to identify the customer resource. This identifier has no meaning to the account owner.
      - `PartyNumber` string: Number assigned by an agent to identify its customer.
      - `PartyType` 'Delegate' | 'Joint' | 'Sole': Party type, in a coded form. For a full list see `OBInternalPartyType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
      - `Name` string: Name by which a party is known and which is usually used to identify that party.
      - `FullLegalName` string: The full legal name of the party.
      - `LegalStructure` string: Legal standing of the party. For a full list refer to `OBInternalLegalStructureType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
      - `LEI` string: Legal entity identification as an alternate identification for a party. Legal Entity Identifier is a code allocated to a party as described in ISO 17442 "Financial Services - Legal Entity Identifier (LEI)".
      - `BeneficialOwnership` boolean: A flag to indicate a party's beneficial ownership of the related account
      - `AccountRole` string: A party’s role with respect to the related account. For a full list refer to `OBInternalAccountRole1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
      - `EmailAddress` string: Address for electronic mail (e-mail).
      - `Phone` string: Collection of information that identifies a phone number, as defined by telecom services.
      - `Mobile` string: Collection of information that identifies a mobile phone number, as defined by telecom services.
      - `Relationships` OBPartyRelationships1: The Party's relationships with other resources.
        - `Account` object: Relationship to the Account resource.
          - `Related` string, uri, required: Absolute URI to the related resource.
          - `Id` string, required: Unique identification as assigned by the ASPSP to uniquely identify the related resource.
      - `Address` OBPostalAddress7[]
        - `AddressType` 'BIZZ' | 'DLVY' | 'MLTO' | 'PBOX' | 'ADDR' | 'HOME' | 'CORR' | 'STAT': Identifies the nature of the postal address. <br /> For a full set of codes see `OBAddressType2Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets).
        - `Department` string: Identification of a division of a large organisation or building.
        - `SubDepartment` string: Identification of a sub-division of a large organisation or building.
        - `StreetName` string: Name of a street or thoroughfare.
        - `BuildingNumber` string: Number that identifies the position of a building on a street.
        - `BuildingName` string: Name of a referenced building.
        - `Floor` string: Number that identifies the level within a building
        - `UnitNumber` string: Number that identifies the unit of a specific address .
        - `Room` string: Information that locates and identifies a room to form part of an address
        - `PostBox` string: Information that locates and identifies a box in a post office assigned to a person or organization, where letters for them are kept until called for.
        - `TownLocationName` string: Name of a built-up area, with defined boundaries, and a local government.
        - `DistrictName` string: Number that of the regional area, known as a district, which forms part of an address
        - `CareOf` string: The 'care of' address is used whenever sending mail to a person or organisation who does not actually live or work at the address. They will receive the mail for the individual.
        - `PostCode` string: Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
        - `TownName` string: Name of a built-up area, with defined boundaries, and a local government.
        - `CountrySubDivision` string: Identifies a subdivision of a country such as state, region, county.
        - `Country` string: Nation with its own government.
        - `AddressLine` string[]
  - `Links` Links: Links relevant to the payload
    - `Self` string, uri, required
    - `First` string, uri
    - `Prev` string, uri
    - `Next` string, uri
    - `Last` string, uri
  - `Meta` Meta: Meta Data relevant to the payload
    - `TotalPages` integer
    - `FirstAvailableDateTime` string, date-time: All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
    - `LastAvailableDateTime` string, date-time: All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `405`: Method Not Allowed
- `406`: Not Acceptable
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

- **2025-11-20** `a96a922860eb`: 1 info
  - added the new optional `header` request parameter `x-client-id`

[Operation history](https://skmtc.dev/openbankinguk/apis/account-and-transaction-api-specification/changes/accounts/:AccountId/parties/get.md)

---

[API](https://skmtc.dev/openbankinguk/apis/account-and-transaction-api-specification.md) - [All operations](https://skmtc.dev/openbankinguk/apis/account-and-transaction-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/openbankinguk/apis/account-and-transaction-api-specification/revisions/705bbf8a4a65?raw)