---
title: "PostalAddress"
canonical: "https://openfinanceguide.com/en/stet/1.6.3/resources/postal-address"
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."
---

# PostalAddress

Type: `object` · Kind: ISO20022

ISO20022: Information that locates and identifies a specific address, as defined by postal services.

Fields:

- `addressType`, `string` — ISO20022: Identifies the nature of the postal address.
  API: Cannot be used for SEPA payments. Proprietary codes can be specified and documented if needed.
  Values:
  - `BIZZ` — Business: Address is the business address
  - `DLVY` — Delivery: Address is the address to which delivery is to take place
  - `MLTO` — Mail To: Address is the  address to which mail is sent
  - `PBOX` — PO Box: Address is is a postal office (PO) box
  - `ADDR` — Postal: Address is the complete postal address
  - `HOME` — Home: Address is the home address
- `department`, `string` — ISO20022: Identification of a division of a large organisation or building.
  API: Cannot be used for SEPA payments.
  Constraints: maxLength 70.
- `subDepartment`, `string` — ISO20022: Identification of a sub-division of a large organisation or building.
  API: Cannot be used for SEPA payments.
  Constraints: maxLength 70.
- `streetName`, `string` — ISO20022: Name of a street or thoroughfare.
  API: Cannot be used for SEPA payments.
  Constraints: maxLength 70.
- `buildingNumber`, `string` — ISO20022: Number that identifies the position of a building on a street.
  API: Cannot be used for SEPA payments.
  Constraints: maxLength 16.
- `buildingName`, `string` — ISO20022: Name of the building or house.
  API: Cannot be used for SEPA payments.
  Constraints: maxLength 16.
- `postCode`, `string` — ISO20022: Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
  API: Cannot be used for SEPA payments.
  Constraints: maxLength 16.
- `townName`, `string` — ISO20022: Name of a built-up area, with defined boundaries, and a local government.
  API: Cannot be used for SEPA payments.
  Constraints: maxLength 35.
- `countrySubDivision`, `string` — ISO20022: Identifies a subdivision of a country such as state, region, county.
  API: Cannot be used for SEPA payments.
  Constraints: maxLength 35.
- `country`, `string`, required — ISO20022: Country in which a person resides (the place of a person's home). In the case of a company, it is the country from which the affairs of that company are directed.
  Constraints: pattern `^([A-Z]{2,2})$`.
- `addressLine`, array of `string` — Unstructured address. The lines must embed zip code and town name.
  For SEPA payments, only two address lines are allowed.
  Item constraints: maxLength 70.
  Items: Address line

## Example

```json
{
  "country": "FR",
  "addressLine": [
    "18 rue de la DSP2",
    "75008 PARIS"
  ]
}
```

## Used by

- `GET /accounts/{accountResourceId}/transactions` (accountsTransactionsGet)
- `POST /payment-requests/{paymentRequestResourceId}/confirmation` (paymentRequestConfirmationPost)
- `PUT /payment-requests/{paymentRequestResourceId}` (paymentRequestPut)
- `GET /payment-requests/{paymentRequestResourceId}` (paymentRequestsGet)
- `POST /payment-requests` (paymentRequestsPost)
- `GET /payment-requests/{paymentRequestResourceId}/transactions` (paymentRequestTransactionsGet)
- `GET /trusted-beneficiaries` (trustedBeneficiariesGet)