---
title: "Get Party"
method: GET
path: "/party"
tags: ["Parties"]
---

# Get Party

`GET /party`

Retrieve details about the party that gave permission to the AISP to view an account(s).

## 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

- OBReadParty2
  - `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

---

[API](https://skmtc.net/openbankinguk/apis/account-and-transaction-api-specification.md) · [All operations](https://skmtc.net/openbankinguk/apis/account-and-transaction-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openbankinguk/account-and-transaction-api-specification/revisions/b1c449c8ecb0/schema)