--- title: "Partner Match API" slug: "partner-match-api-1" updated: 2025-02-27T19:24:11Z published: 2025-02-27T19:24:11Z canonical: "help.yahooinc.com/partner-match-api-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.yahooinc.com/llms.txt > Use this file to discover all available pages before exploring further. # Partner Match API DataX’s Partner Match API audiences are keyed to an external Partner ID in a secured Yahoo Ad Tech database that will process and store all successful mappings. > [!WARNING] > Note > > Unmatched links will be removed from the system. ## Updates The Partner Match API is now available to upload hashed emails, hashed phone numbers and external Partner ID mapping data to Yahoo Ad Tech. The header and parameters are listed in the following table: | **Parameter Name** | **Type** | **Sample Value** | **Optional** | | --- | --- | --- | --- | | X-DATAX-URNTYPE | String | PXID,pxid | No | | data | application/octet-stream | File_name of the file which is compressed in bz2 format | No | | panel | String | IRI (case insensitive) | Yes | | schema | String | PXID,SHA256EMAIL,SHA256PHONE | Yes | ## Endpoint ```plaintext https://datax.yahooapis.com/v1/usermatch ``` POST /v1/usermatch ### Sample Request ```plaintext curl -X POST "https://datax.yahooapis.com/v1/usermatch" -H "accept: application/json" -H "X-DATAX-URNTYPE: pxid" -H "X-DATAX-APP-ID: YAHOO" -H "Content-Type: multipart/form-data" -F "data=@hashedemail.csv.bz2;type=application/x-bzip2" ``` ### Sample Response ```plaintext {  "resourceType": "datax-usermatch",  "resourceId": "YAHOO.usermatch.20200828T152057Z719526632",  "createTime": "2020-08-28T07:20:57Z",  "bytes": 93,  "links": [    {      "rel": "self",      "title": "A link to this meta data itself",      "href": "https://datax.yahooapis.com/link/self/YAHOO.usermatch.20200828T152057Z719526632"    },    {      "rel": "describes",      "title": "A link to the data this metadata describes",      "href": "https://datax.yahooapis.com/link/describes/YAHOO.usermatch.20200828T152057Z719526632"    },  {      "rel": "matched metric",      "title": "A link to get the matched metric for specific upload and it is ready 1+ day after uploading ",      "href": "https://datax.yahooapis.com/link/stats/YAHOO.usermatch.20200828T152057Z719526632?type=UserMatch"    }, {      "rel": "download matched record",      "title": "A link to download the detail matched record for specific upload and it is ready 1+ day after uploading",      "href": "https://datax.yahooapis.com/link/downloadmatch/YAHOO.usermatch.20200828T152057Z719526632"    }  ],  "status": {    "state": "UPLOADING",    "lastUpdateTime": "2020-08-28T15:20:57Z"  },  "extensions": {    "urnType": "PXID",    "view": "INCREMENTAL"  } } ``` > [!NOTE] > Note > > User partner matched IDs are available to download for 14 days from the time of ingestion. After 14 days, the downloadable link will expire. > [!WARNING] > Important > > DataX has an upload size limitation of 5GB per file in a .bz2 compressed format. Although the limit on payload size of uploads is reasonably high, it is strongly recommended that data be uploaded in frequent mini-batches of incremental updates to optimize reach.