# Table of contents:

• Introduction
• Client/Request
  • ABFindAll
    • abId
    • abView
    • deltasOnly
    • lastChange
• Server/Response
  • ABFindAllResponse
    • ABFindAllResult
      • groups
        • Group
          • groupInfo
            • Annotation
      • contacts
        • Contact
      • DynamicItems
        • DynamicItem
          • Notifications
            • NotificationData
              • StoreService
                • Info
                  • Handle
      • ab
        • abInfo
• Examples
  • Client/Request
  • Server/Response

# Introduction

ABFindAll is one of the SOAP actions the Address Book Service provides.

Returns the full list of contacts in the Forward List (FL). For retrieving information about other lists, read the FindMembership article.

Responding to a request with a ABDoesNotExist error will cause the client to request a ABAdd action.

# Client/Request

The template used in this action is described on the Address Book Service main page.

# ABFindAll

This element has only one attribute:

• xmlns: This is always set to http://www.msn.com/webservices/AddressBook.

# abId

This element contains your Address Book Service GUID.

# abView

Always set to Full.

# deltasOnly

If set to true, the <lastChange> value is compared against the server to only provide the updates since the timestamp provided.

# lastChange

This is a ISO 8601 timestamp which denotes the last time you retrieved the Forward List (FL), comes from the response's <createDate> element inside the <ab> element.

# Server/Response

# ABFindAllResponse

This element has only one attribute:

• xmlns: This is always set to http://www.msn.com/webservices/AddressBook.

This element only contains the <ABFindAllResult> element.

# ABFindAllResult
# groups

This element contains any amount of <Group> elements.

# Group

This element contains five children:

• <groupId>: The group's GUID.
• <groupInfo>: Described below.
• <propertiesChanged>: Contains a space delimited list of changed elements in <groupInfo>:
  • GroupName
• <fDeleted>: Is this group deleted? (true or false).
• <lastChange>: The ISO 8601 timestamp of the time this group was last modified.

# groupInfo

This element contains six children:

• <annotations>: This element contains multiple <Annotation> elements.
• <groupType>: Only known to be set to c8529ce2-6ead-434d-881f-341e17db3ff8.
• <name>: The group's name
• <IsNotMobileVisible>: If this is set to true, this group is not shown to mobile clients. Otherwise, it is set to false.
• <IsPrivate>: If this is set to true, this group is private. Otherwise, it is set to false.
• <IsFavorite>: If this is set to true, this group is the Favorites group. Otherwise, it is set to false.

# Annotation

This element contains two children:

• <Name>: The key of this annotation:
  • MSN.IM.Display: Is this group shown to the Official Client? (1 or 0)
• <Value>: The value of this annotation.

# contacts

This element contains any amount of <Contact> elements.

# Contact

This element contains five children:

• <contactId>: The GUID of this contact.
• <contactInfo: Described on it's own page.
• <propertiesChanged>: Contains a space delimited list of changed elements in <contactInfo>:
  • DisplayName
  • IsMessengerUser
  • ContactFirstName
  • ContactLastName
  • Comment
  • MiddleName
  • ContactPrimaryEmailType
  • ContactEmail
  • ContactLocation
  • ContactPhone
  • ContactWebSite
  • Annotation
• <fDeleted>: Is this contact deleted? (true or false)
• <lastChange>: The ISO 8601 timestamp of the time this contact was last modified.

# DynamicItems

This optional element contains any amount of <DynamicItem> elements.

# DynamicItem

This element has only one attribute:

• xsi:type: The type of this <DynamicItem>:
  • PassportDynamicItem

This element has two children and only one optional child:

• <Type>: The type of this <DynamicItem>:
  • Passport
• <Notifications>: Optional. Described below.
• <Changes>: A space delimited list of elements changed in this <DynamicItem>.

If the type of this <DynamicItem> is a PassportDynamicItem, the element has another child and five optional children:

• <PassportName>: The user handle associated with this <DynamicItem>.
• <SpaceStatus>: Optional. If this is set to Access, the user has a blog.
• <SpaceLastChanged>: Optional. The ISO 8601 timestamp of the time of when the user's blog was last updated.
• <SpaceLastViewed>: Optional. The ISO 8601 timestamp of the time you have last viewed this user's blog.
• <SpaceGleam>: Optional. If this is set to true, the user's gleam state is activated for their blog.
• <CID>: Optional. The Common ID associated with the user specified in <PassportName>.

# Notifications

This element contains one or more <NotificationData> elements.

# NotificationData

This element has five children:

• <StoreService>: Described below.
• <Status>: A space delimited list of statuses:
  • Exist
  • Access
• <LastChanged>: The ISO 8601 timestamp of the current time.
• <Gleam>: Does notifications from this service update the gleam state?
• <InstanceId>: Unknown. Observed to always be 0.

# StoreService

This element has four children:

• <Info>: Described below.
• <Changes>: A space delimited list of elements changed in this <DynamicItem>.
• <LastChange>: A ISO 8601 timestamp that is always set to 0001-01-01T00:00:00.
• <Deleted>: Always false.

# Info

This element has three children:

• <Handle>: Described below.
• <InverseRequired>: Always set to false.
• <IsBot>: Is this <StoreService> for a provisioned account? (true or false).

# Handle

This element has three children:

• <Id>: This is always 0.
• <Type>: The type of this <StoreService>, which is always Profile.
• <ForeignId>: Unknown. Observed to always be MyProfile.

# ab

This element contains seven children:

• <abId>: Your Address Book Service GUID.
• <abInfo>: Described below.
• <lastChange>: The ISO 8601 timestamp of the time a change was last made to the Address Book.
• <DynamicItemLastChanged>: The ISO 8601 timestamp of the time any dynamic item was last modified.
• <RecentActivityItemLastChanged>: The ISO 8601 timestamp of the time a "recent activity item" was last modified.
• <createDate>: The ISO 8601 timestamp of the time this Address Book was created.
• <propertiesChanged>: Contains a space delimited list of changed elements in an unknown location.

# abInfo

This element contains ten children:

• <ownerPuid>: This is always set to 0.
• <OwnerCID>: Your Common ID, an signed 64-bit integer.
• <ownerEmail>: Your user handle.
• <fDefault>: Is this the default Address Book? (true or false)
• <joinedNamespace>: unknown (true or false)
• <IsBot>: Is this account provisioned? (true or false)
• <IsParentManaged>: Is this a children's account? (true or false)
• <SubscribeExternalPartner>: unknown (true or false)
• <NotifyExternalPartner>: unknown (true or false)
• <AddressBookType>: This is always set to Individual.

# Examples

# Client/Request

POST /abservice/abservice.asmx HTTP/1.1
SOAPAction: http://www.msn.com/webservices/AddressBook/ABFindAll
Cache-Control: no-cache
Content-Type: text/xml; charset=utf-8
Content-Length: 1048

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
	xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
	xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
>
	<soap:Header>
		<ABApplicationHeader xmlns="http://www.msn.com/webservices/AddressBook">
			<ApplicationID>996CDE1E-AA53-4477-B943-2BE802EA6166</ApplicationID>
			<IsMigration>false</IsMigration>
			<PartnerScenario>ContactSave</PartnerScenario>
		</ABApplicationHeader>
		<ABAuthHeader xmlns="http://www.msn.com/webservices/AddressBook">
			<ManagedGroupRequest>false</ManagedGroupRequest>
			<TicketToken>t=ticket&amp;p=profile</TicketToken>
		</ABAuthHeader>
	</soap:Header>
	<soap:Body>
		<ABFindAll xmlns="http://www.msn.com/webservices/AddressBook">
			<abId>00000000-0000-0000-0000-000000000000</abId>
			<abView>Full</abView>
			<deltasOnly>false</deltasOnly>
			<lastChange>0001-01-01T00:00:00.0000000-08:00</lastChange>
		</ABFindAll>
	</soap:Body>
</soap:Envelope>

# Server/Response

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: 7434

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
	xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
>
	<soap:Header>
		<ServiceHeader xmlns="http://www.msn.com/webservices/AddressBook">
			<Version>12.01.1111.0000</Version>
			<CacheKey>12r1;MjAyNC0xMS0yMFQxMToyMDoyNy43MTVa</CacheKey>
			<CacheKeyChanged>true</CacheKeyChanged>
			<PreferredHostName>contacts.example.com</PreferredHostName>
			<SessionId>ecfaf8c7-e388-4571-8641-b061a0ac4bdc</SessionId>
		</ServiceHeader>
	</soap:Header>
	<soap:Body>
		<ABFindAllResponse xmlns="http://www.msn.com/webservices/AddressBook">
			<ABFindAllResult>
				<groups>
					<Group>
						<groupId>f60efbe7-94af-4b16-b926-e4e10878d329</groupId>
						<groupInfo>
							<annotations>
								<Annotation>
									<Name>MSN.IM.Display</Name>
									<Value>1</Value>
								</Annotation>
							</annotations>
							<groupType>c8529ce2-6ead-434d-881f-341e17db3ff8</groupType>
							<name>Friends</name>
							<IsNotMobileVisible>false</IsNotMobileVisible>
							<IsPrivate>false</IsPrivate>
							<IsFavorite>false</IsFavorite>
						</groupInfo>
					</Group>
				</groups>
				<contacts>
					<Contact>
						<contactId>c1f9a363-4ee9-4a33-a434-b056a4c55b98</contactId>
						<contactInfo>
							<contactType>Regular</contactType>
							<quickName>anotheruser</quickName>
							<passportName>anotheruser@hotmail.com</passportName>
							<IsPassportNameHidden>false</IsPassportNameHidden>
							<displayName>another user</displayName>
							<puid>0</puid>
							<groupIds>
								<guid>f60efbe7-94af-4b16-b926-e4e10878d329</guid>
							</groupIds>
							<CID>4388220788362762</CID>
							<IsNotMobileVisible>false</IsNotMobileVisible>
							<isMobileIMEnabled>false</isMobileIMEmabled>
							<isMessengerUser>true</isMessengerUser>
							<isFavorite>false</isFavorite>
							<isSmtp>false</isSmtp>
							<hasSpace>false</hasSpace>
							<spotWatchState>NoDevice</spotWatchState>
							<birthdate>0001-01-01T00:00:00</birthdate>
							<primaryEmailType>ContactEmailPersonal</primaryEmailType>
							<PrimaryLocation>ContactLocationPersonal</PrimaryLocation>
							<PrimaryPhone>ContactPhonePersonal</PrimaryPhone>
							<IsPrivate>false</IsPrivate>
							<Gender>Unspecified</Gender>
							<TimeZone>None</TimeZone>
						</contactInfo>
						<propertiesChanged />
						<fDeleted>false</fDeleted>
						<lastChange>2024-11-20T11:43:00.1230000-08:00</lastChange>
					</Contact>
					<Contact>
						<contactId>a47e39cf-312c-4100-94a6-f2b33adf5b68</contactId>
						<contactInfo>
							<phones>
								<ContactPhone>
									<contactPhoneType>ContactPhoneMobile</contactPhoneType>
									<number>15551111222</number>
									<isMessengerEnabled>true</isMessengerEnabled>
									<propertiesChanged />
								</ContactPhone>
							</phones>
							<contactType>Regular</contactType>
							<quickName>john</quickName>
							<IsPassportNameHidden>false</IsPassportNameHidden>
							<displayName>john</displayName>
							<puid>0</puid>
							<CID>0</CID>
							<IsNotMobileVisible>false</IsNotMobileVisible>
							<isMobileIMEnabled>true</isMobileIMEnabled>
							<isMessengerUser>false</isMessengerUser>
							<isFavorite>false</isFavorite>
							<isSmtp>false</isSmtp>
							<hasSpace>false</hasSpace>
							<spotWatchState>NoDevice</spotWatchState>
							<birthdate>0001-01-01T00:00:00</birthdate>
							<primaryEmailType>ContactEmailPersonal</primaryEmailType>
							<PrimaryLocation>ContactLocationPersonal</PrimaryLocation>
							<PrimaryPhone>ContactPhoneMobile</PrimaryPhone>
							<IsPrivate>false</IsPrivate>
							<Gender>Unspecified</Gender>
							<TimeZone>None</TimeZone>
						</contactInfo>
						<propertiesChanged />
						<fDeleted>false</fDeleted>
						<lastChange>2024-11-20T11:44:40.4560000-08:00</lastChange>
					</Contact>
					<Contact>
						<contactId>c867a811-089f-4c4c-a601-e983881f003a</contactId>
						<contactInfo>
							<annotations>
								<Annotation>
									<Name>MSN.IM.MBEA</Name>
									<Value>0</Value>
								</Annotation>
								<Annotation>
									<Name>MSN.IM.GTC</Name>
									<Value>1</Value>
								</Annotation>
								<Annotation>
									<Name>MSN.IM.BLP</Name>
									<Value>1</Value>
								</Annotation>
							</annotations>
							<phones>
								<ContactPhone>
									<contactPhoneType>ContactPhonePersonal</contactPhoneType>
									<number>123 (4567)</number>
								</ContactPhone>
							</phones>
							<contactType>Me</contactType>
							<quickName>Q</quickName>
							<passportName>example@hotmail.com</passportName>
							<IsPassportNameHidden>false</IsPassportNameHidden>
							<displayName>example user</displayName>
							<puid>0</puid>
							<CID>4294967298</CID>
							<IsNotMobileVisible>false</IsNotMobileVisible>
							<isMobileIMEnabled>false</isMobileIMEnabled>
							<isMessengerUser>false</isMessengerUser>
							<isFavorite>false</isFavorite>
							<isSmtp>false</isSmtp>
							<hasSpace>false</hasSpace>
							<spotWatchState>NoDevice</spotWatchState>
							<birthdate>0001-01-01T00:00:00</birthdate>
							<primaryEmailType>ContactEmailPersonal</primaryEmailType>
							<PrimaryLocation>ContactLocationPersonal</PrimaryLocation>
							<PrimaryPhone>ContactPhonePersonal</PrimaryPhone>
							<IsPrivate>false</IsPrivate>
							<Gender>Unspecified</Gender>
							<TimeZone>None</TimeZone>
						</contactInfo>
						<propertiesChanged />
						<fDeleted>false</fDeleted>
						<lastChange>2024-11-20T11:26:00.4180000-08:00</lastChange>
					</Contact>
				</contacts>
				<DynamicItems>
					<DynamicItem xsi:type="PassportDynamicItem">
						<Type>Passport</Type>
						<PassportName>example@hotmail.com</PassportName>
						<Notifications>
							<NotificationData>
								<StoreService>
									<Info>
										<Handle>
											<Id>0</Id>
											<Type>Profile</Type>
											<ForeignId>MyProfile</ForeignId>
										</Handle>
										<InverseRequired>false</InverseRequired>
										<IsBot>false</IsBot>
									</Info>
									<Changes />
									<LastChange>0001-01-01T00:00:00</LastChange>
									<Deleted>false</Deleted>
								</StoreService>
								<Status>Exist Access</Status>
								<LastChanged>2026-02-08T18:10:16.2824158-05:00</LastChanged>
								<Gleam>false</Gleam>
								<InstanceId>0</InstanceId>
							</NotificationData>
						</Notifications>
						<Changes>Notifications</Changes>
					</DynamicItem>
				</DynamicItems>
				<ab>
					<abId>00000000-0000-0000-0000-000000000000</abId>
					<abInfo>
						<ownerPuid>0</ownerPuid>
						<OwnerCID>4294967298</OwnerCID>
						<ownerEmail>example@hotmail.com</ownerEmail>
						<fDefault>true</fDefault>
						<joinedNamespace>false</joinedNamespace>
						<IsBot>false</IsBot>
						<IsParentManaged>false</IsParentManaged>
						<SubscribeExternalPartner>false</SubscribeExternalPartner>
						<NotifyExternalPartner>false</NotifyExternalPartner>
						<AddressBookType>Individual</AddressBookType>
					</abInfo>
					<lastChange>2024-11-20T11:26:00.4180000-08:00</lastChange>
					<DynamicItemLastChanged>0001-01-01T00:00:00</DynamicItemLastChanged>
					<createDate>2024-10-10T20:38:51.0000000-08:00</createDate>
				</ab>
			</ABFindAllResult>
		</ABFindAllResponse>
	</soap:Body>
</soap:Envelope>