added more detail on response properties

Author: sophia-chen-ttd

docs/endpoints/post-identity-map.md

@@ -9,7 +9,7 @@ import Link from '@docusaurus/Link';
 
 # POST /identity/map
 
-Maps multiple email addresses, phone numbers, or their respective hashes to their raw UID2s. You can also use this endpoint to check for updates to opt-out information, check when an advertisting ID may be refreshed or view the previous advertising ID for advertising IDs that are less than 90 days old.
+Maps multiple email addresses, phone numbers, or their respective hashes to their raw UID2s. You can also use this endpoint to check for updates to opt-out information, check when an advertisting ID may be refreshed, or view the previous advertising ID for advertising IDs that are less than 90 days old.
 
 Used by: This endpoint is used mainly by advertisers and data providers. For details, see [Advertiser/Data Provider Integration Overview](../guides/integration-advertiser-dataprovider-overview.md).
 
@@ -32,7 +32,7 @@ Here's what you need to know:
 
 ## Request Format
 
-`POST '{environment}/v2/identity/map'`
+`POST '{environment}/v3/identity/map'`
 
 For authentication details, see [Authentication and Authorization](../getting-started/gs-auth.md).
 
@@ -56,19 +56,20 @@ The integration environment and the production environment require different <Li
 You can include one or more of the following four parameters as a key-value pair in the JSON body of the request when encrypting it.
 :::
 
-| Body Parameter | Data Type        | Attribute | Description |
-| :--- |:-----------------| :--- | :--- |
-| `email` | DII object array | Conditionally Required | The list of email addresses to be mapped. |
-| `email_hash` | DII object array | Conditionally Required | The list of [Base64-encoded SHA-256](../getting-started/gs-normalization-encoding.md#email-address-hash-encoding) hashes of [normalized](../getting-started/gs-normalization-encoding.md#email-address-normalization) email addresses to be mapped. |
-| `phone` | DII object array | Conditionally Required | The list of [normalized](../getting-started/gs-normalization-encoding.md#phone-number-normalization) phone numbers to be mapped. |
-| `phone_hash` | DII object array | Conditionally Required | The list of [Base64-encoded SHA-256](../getting-started/gs-normalization-encoding.md#phone-number-hash-encoding) hashes of [normalized](../getting-started/gs-normalization-encoding.md#phone-number-normalization) phone numbers to be mapped. |
+| Body Parameter | Data Type            | Attribute | Description |
+| :--- |:---------------------| :--- | :--- |
+| `email` | array of DII objects | Conditionally Required | The list of email addresses to be mapped. |
+| `email_hash` | array of DII objects | Conditionally Required | The list of [Base64-encoded SHA-256](../getting-started/gs-normalization-encoding.md#email-address-hash-encoding) hashes of [normalized](../getting-started/gs-normalization-encoding.md#email-address-normalization) email addresses to be mapped. |
+| `phone` | array of DII objects | Conditionally Required | The list of [normalized](../getting-started/gs-normalization-encoding.md#phone-number-normalization) phone numbers to be mapped. |
+| `phone_hash` | array of DII objects | Conditionally Required | The list of [Base64-encoded SHA-256](../getting-started/gs-normalization-encoding.md#phone-number-hash-encoding) hashes of [normalized](../getting-started/gs-normalization-encoding.md#phone-number-normalization) phone numbers to be mapped. |
 
 #### DII Object
-Each DII i.e. email address, email hash, phone or phone hash is input as a DII object.
 
-| DII Object Parameter | Data Type | Attribute | Description |
-| :--- | :---- | :---- |:------------|
-| `i` | string | Required | The DII input i.e. email address, email hash, phone or phone hash
+Each DII i.e. email address, email hash, phone or phone hash, is input as a DII object.
+
+| Parameter | Data Type | Attribute | Description |
+|:----------| :---- | :---- |:------------|
+| `i`       | string | Required | The email address, email hash, phone or phone hash
 
 ### Request Examples
 
@@ -115,6 +116,7 @@ The response is encrypted only if the HTTP status code is 200. Otherwise, the re
 :::
 
 A successful decrypted response returns the raw UID2s for the specified email addresses, phone numbers, or their respective hashes in the same array order that was given.
+Identifiers that cannot be mapped to an advertising ID are mapped to an error object with the reason for unsuccessful mapping. An unsuccessful mapping will occur if the identifier is considered invalid or if the identifier has opted out from the UID2 ecosystem. In these cases, the response status is still "success".
 
 ```json
 {
@@ -129,7 +131,9 @@ A successful decrypted response returns the raw UID2s for the specified email ad
                 "u": "IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ=",
                 "p": null,
                 "r": 1735862400000
-            }
+            },
+            { "e": "invalid identifier" },
+            { "e": "optout" }
         ],
       "email_hash": [],
       "phone": [],
@@ -139,34 +143,28 @@ A successful decrypted response returns the raw UID2s for the specified email ad
 }
 ```
 
-Identifiers that cannot be mapped to an advertising ID are mapped to an error object with the reason for unsuccessful mapping. This will occur if the identifier is considered invalid or if the identifier has opted out from the UID2 ecosystem. In these cases, the response status is still "success".
 
-```json
-{
-    "body":{
-        "email": [
-            { "e": "invalid identifier" },
-            { "e": "optout" }
-        ],
-        "email_hash": [],
-        "phone": [],
-        "phone_hash": []
-    },
-    "status":"success"
-}
-```
 
 ### Response Body Properties
 
-For successfully mapped DIIs, the response body includes the properties shown in the following table.
+| Body Parameter | Data Type                   | Attribute | Description                                                                                |
+| :--- |:----------------------------| :--- |:-------------------------------------------------------------------------------------------|
+| `email` | array of mapped DII objects | Conditionally Required | The list of mapped DII objects corresponding to the list of given emails.                  |
+| `email_hash` | array of mapped DII objects | Conditionally Required | The list of mapped DII objects corresponding to the list of given email hashes.        |
+| `phone` | array of mapped DII objects | Conditionally Required | The list of mapped DII objects corresponding to the list of given phone numbers.       |
+| `phone_hash` | array of mapped DII objects | Conditionally Required | The list of mapped DII objects corresponding to the list of given phone number hashes. |
+
+#### Mapped DII Objects
+
+For successfully mapped DIIs, the mapped object includes the properties shown in the following table.
 
 | Property | Data Type  | Description                                                                                                                           |
 |:---------|:-----------|:--------------------------------------------------------------------------------------------------------------------------------------|
 | `u`      | string     | The advertising ID (raw UID2) of the DII given in the request.                                                                        |
 | `p`      | string     | The previous advertising ID if the current ID has been refreshed in the last 90 days. `Null` if the current ID is older than 90 days. |
 | `r`      | number     | The Unix timestamp (in milliseconds) that indicates when the advertising ID may be refreshed.                                         |
 
-For unsuccessfully mapped DIIs, the response body includes the properties shown in the following table.
+For unsuccessfully mapped DIIs, the mapped object includes the properties shown in the following table.
 
 | Property | Data Type | Description                                                                                    |
 |:---------|:----------|:-----------------------------------------------------------------------------------------------|