--- title: "Get a contact detail" description: "Get the contact details of a financial or shareholder contact." url: "https://docs.adyen.com/account-management-api/manage-contact-details/getcontactdetail" source_url: "https://docs.adyen.com/account-management-api/manage-contact-details/getcontactdetail.md" canonical: "https://docs.adyen.com/account-management-api/manage-contact-details/getcontactdetail" last_modified: "2026-05-25T12:55:01+02:00" language: "en" --- # Get a contact detail Get the contact details of a financial or shareholder contact. [View source](/account-management-api/manage-contact-details/getcontactdetail.md) ## Request parameters To get the contact details of a contact type associated with a merchant account, make a POST `/getContactDetail` request specifying: | Name | Type | Required | Description | | -------------- | ------ | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `contactType` | enum | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The type of contact whose details you want to retrieve. Allowed values:- `financialContact` - `shareHolder1` - `shareHolder2` - `shareHolder3` - `shareHolder4` | | `merchantCode` | String | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | A merchant code string holds a value to identify a merchant.Format:- Either: `MerchantAccount.Merchant_Code` - Or: `Merchant_Code` | ## Response parameters If there are no errors in the request, the call returns detailed information about the requested contact. If any issues occur during the process, the call returns one or more warning or error messages. | Name | | | Type | Returned by default | Description | | -------------- | -------------------- | ---------------------- | ------ | ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `pspReference` | | | String | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | A reference to uniquely identify the request. | | `contact` | | | class | ![-x-](/user/data/smileys/emoji/x.png "-x-") | A container object for contact type dataThis field holds the following child element(s):- `address` - `name` - `personalData` - `PhoneNumber` - `fullPhoneNumber` - `email` - `webAddress` | | | \|-`fullPhoneNumber` | | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | Complete telephone number, i.e. *country code + area code + phone number*, represented as one string. For example: *0031 6 11 22 33 44*; *+316/1122-3344*; *(0031) 611223344.*It is handled as a `Landline` phone type. Max. length: 14 chars. | | | \|-`email` | | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | The email address associated with the user account. | | | \|-`webAddress` | | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | Web address of the contact. | | | \|-`address` | | class | ![-x-](/user/data/smileys/emoji/x.png "-x-") | A container object for address details.This field holds the following child element(s):- `city` - `country` - `houseNumberOrName` - `postalCode` - `stateOrProvince` - `street` | | | | \|-`city` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | The city the contact operates from. | | | | \|-`country` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | The country the contact operates from. The `country` value format needs to adhere to the [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) standard. An invalid country code results in a transaction/request rejection. You can [look up country codes](https://www.iso.org/obp/ui/) on the ISO website. | | | | \|-`houseNumberOrName` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | House number or name of the building the contact operates from. | | | | \|-`postalCode` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | ZIP code.Character limitations:- US ZIP code: max. 5 chars. - Any other country/region: max. 10 chars. | | | | \|-`stateOrProvince` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | State, region or province the contact operates from. | | | | \|-`street` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | Street address. | | | \|-`name` | | class | ![-x-](/user/data/smileys/emoji/x.png "-x-") | A container object for personal data- `firstName` - `lastName` | | | | \|-`firstName` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | The first name/given name of the user.- Max. length: 80 characters | | | | \|-`lastName` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | The last name/family name of the user.- Max. length: 80 characters | | | \|-`personalData` | | class | ![-x-](/user/data/smileys/emoji/x.png "-x-") | A container object for personal information details.- `dateOfBirth` - `idNumber` - `nationality` | | | | \|-`dateOfBirth` | class | ![-x-](/user/data/smileys/emoji/x.png "-x-") | The shopper's date of birth.Format: [ISO-8601](https://www.w3.org/TR/NOTE-datetime); example: YYYY-MM-DD | | | | \|-`idNumber` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | A unique identifier for the contact type. | | | | \|-`nationality` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | Nationality of the contact.The `country` value format needs to adhere to the [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) standard. An invalid country code results in a transaction/request rejection. You can [look up country codes](https://www.iso.org/obp/ui/) on the ISO website.  | | | \|-`PhoneNumber` | | class | ![-x-](/user/data/smileys/emoji/x.png "-x-") | A container object for telephone details.This field holds the following child element(s):- `phoneCountryCode` - `phoneNumber` - `phoneType` | | | | \|-`phoneCountryCode` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | The country the phone line operates from.The `country` value format needs to adhere to the [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) standard. An invalid country code results in a transaction/request rejection. You can [look up country codes](https://www.iso.org/obp/ui/) on the ISO website. | | | | \|-`phoneNumber` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | Telephone number, without the country code. | | | | \|-`phoneType` | enum | ![-x-](/user/data/smileys/emoji/x.png "-x-") | Telephone line type. Allowed values:- `Landline` - `Mobile` - `SIP` - `Fax` | | `warnings` | | | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | List containing one or more warning messages. Returned when the request is not correctly processed. | | `errors` | | | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | List containing one or more error messages. Returned when the request fails. | ## Examples ### Request #### JSON ```json { "contactType":"financialContact", "merchantCode":"TestMerchant" } ``` #### Soap ```xml financialContact TestMerchant   ``` ### Response #### JSON ```json { "pspReference":"9914526964220637", "contact":{ "address":{ "city":"Amsterdam", "country":"NL", "postalCode":"1111", "street":"Erstestraat 1" }, "email":"john.doe@testshop.nl", "name":{ "firstName":"John", "lastName":"Doe" }, "personalData":{ "dateOfBirth":"1920-02-20", "idNumber":"NL987654321", "nationality":"NL" }, "phoneNumber":{ "phoneCountryCode":"NL", "phoneNumber":"11223344", "phoneType":"Landline" }, "webAddress":"http:\/\/testshop.nl" } } ``` #### Soap ```xml 9914526964220637 Amsterdam NL 1111 Erstestraat 1 john.doe@testshop.nl John Doe 1920-02-20 NL987654321 NL NL 11223344 Landline http://testshop.nl ```