Validate reseller partner of record (POR)

Use this endpoint to check if one or more partner ___location account (PLA) IDs are associated with an authorized indirect reseller. This API helps you confirm reseller or POR authorization before transactions are made.

Prerequisites

• Credentials as described in Partner Center authentication. This scenario supports authentication with both standalone App and App+User credentials.
• An array of partner IDs that you want to validate.
• Appropriate roles: Admin agent

REST request

Request syntax

Request headers

For more information, see Partner Center REST headers.

Request body

This table describes the required properties in the request body.

Request example

POST https://api.partnercenter.microsoft.com/v1/partners/validateresellers HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 1234ecb8-37af-45f4-a1a1-358de3ca2b9e
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com

{
  "partnerIds": [
    "12345",
    "234567",
    "3456789"
  ]
}

REST response

If successful, this method returns validation results for each partner ID in the response body.

Response example

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 1b18689e-3fe3-4fdb-d09e-39d13941390b
X-Locale: en-US
Date: Thu, 19 Jun 2025 18:15:06 GMT
Content-Length: 1234

{
  "validationResults": [
    {
      "partnerId": "12345",
      "isValidPartnerIdOnRecord": true
    },
    {
      "partnerId": "234567",
      "isValidPartnerIdOnRecord": false,
      "errorCode": 900400,
      "errorDescription": "The PLA ID (formerly MPN ID) is not linked to any active reseller tenant."
    },
    {
      "partnerId": "3456789",
      "isValidPartnerIdOnRecord": false,
      "errorCode": 900414,
      "errorDescription": "The requested indirect reseller with PLA ID (formerly MPN ID) is not currently authorized to be associated with this transaction. Ensure the reseller has an active CSP indirect reseller tenant. Learn more at https://learn.microsoft.com/en-us/partner-center/customers/indirect-provider-tasks-in partner-center#add-an-indirect-reseller-as-partner-of-record-por-on-a-new-subscriptionpurchase."
    }
  ]
}

Response properties

This table describes the properties in the response.

Response success and error codes

Each response comes with an HTTP status code that indicates success or failure and extra debugging information. Use a network trace tool to read this code, error type, and more parameters. For the full list, see Partner Center REST error codes.

Common error codes

The following table shows common error codes you might see in the response.