--- schema_version: "1" id: f72506de53696242e645edb403160b8a6d2789bfb0db3fd0d4def736407c6e17 title: POST /contacts/v1/addresses/search/{attributeName} collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/fetchContactsAddressesBySearchCriteria.md canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_contacts/fetchContactsAddressesBySearchCriteria.html source_site: developer.salesforce.com content_type: documentation content_hash: 53823bf8f7698ece9f607ef84570f8bff71d914150d38f19e9f4108d975024d9 products: - Marketing Cloud Engagement APIs and Programmatic Languages - Marketing Cloud --- # POST /contacts/v1/addresses/search/{attributeName} ## Overview Fetches all contacts and associated addresses based on search criteria ## URL Parameters | Name | Type | | Description | | ------------- | ------ | -------- | ------------------------------------------------------------------------------------------------- | | attributeName | string | Required | The attribute used in the search criteria: ContactKeyLastModfiedDateSourceChannelStatusAudienceID | ## JSON Parameters | Name | Type | | Description | | ----------------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | filterConditionOperator | string | Required | Filter condition operator name. Currently supports only the "Is" operator | | filterConditionValue | string | Required | Value for attribute used in search criteria for contacts and associated addresses. When using the "LastModfiedDate" attributeName, separate the values for start and end date in the filterconditionValue with an "AND" The "Channel" attributeName supports these values: MOBILE PUSH LINE EMAIL | ## Responses | Status | Name | Type | Description | | ----------- | ----------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------ | | **200** |   |   | **Successfully retrieved contacts and associated addresses** | |   | pageNumber | integer | Page number of results retrieved | |   | pageSize | integer | Page size of results retrieved | |   | addresses | array | Array of all address objects retrieved | |   | addresses.contactID | object | Type-value object specifying ContactID tied to given address | |   | addresses.contactKey | object | Type-value object specifying ContactKey tied to given address | |   | addresses.addressTypeID | integer | Type of the retrieved address: EMAIL: 1 MOBILE: 4 PUSH: 9 LINE: 10 | |   | addresses.addressID | object | Type-value object specifying the AddressID for retrieved address | |   | addresses.addressKey | object | Type-value object specifying the AddressKey for retrieved address | |   | addresses.status | integer | Status value of retrieved address | |   | addresses.ordinal | integer | Ordinal value of retrieved address | |   | addresses.source | integer | Source value of retrieved address | |   | addresses.modifiedDate | string | Last modified date value of retrieved address | |   | addresses.valueSets | array | Object array containing value set information of pertinent attributes retrieved for address | |   | addresses.valueSets.definitionID | guid | Default ID assigned to represent the Set Definition of value Set information for retrieved address | |   | addresses.valueSets.definitionKey | string | Default key assigned to represent the Set Definition of value Set information for retrieved address | |   | addresses.valueSets.definitionName | string | Default name assigned to represent the Set Definition of value Set information for retrieved address | |   | addresses.valueSets.values | array | Object array containing property definition and actual value information of attributes retrieved for address | |   | addresses.valueSets.values.definitionID | guid | The value definition ID of a retrieved attribute for retrieved address | |   | addresses.valueSets.values.definitionKey | string | The value definition key of a retrieved attribute for retrieved address | |   | addresses.valueSets.values.definitionName | string | The value definition name of a retrieved attribute for retrieved address | |   | addresses.valueSets.values.valueID | guid | An auto-generated guid representing a retrieved attribute value for the retrieved address | |   | addresses.valueSets.values.innerValue | string | Actual value of a retrieved attribute for the retrieved address | |   | requestServiceMessageID | guid | Service message ID value of the request | |   | resultMessages | array | Array of returned messages generated while processing the request | |   | serviceMessageID | guid | Service message ID value of the response | |   |   |   |   | | **default** |   |   | **Unexpected error** | |   | pageNumber | integer | Page number of results retrieved | |   | pageSize | integer | Page size of results retrieved | |   | hasErrors | boolean | Indicates errors occured while processing the request | |   | requestServiceMessageID | guid | Service message ID value of request | |   | resultMessages | array | Array of returned error messages generated while processing request | |   | serviceMessageID | guid | Service message ID value of response |