Certificate

A certificate is issued to a client or partner as confirmation that they meet a specific program's requirements. This document is proof that the client or partner has adhered to the vendor's standards and is now eligible to purchase or access their products.

The following rules apply to certificates:

• A certificate can only be created or re-enrolled for published programs.

• A client or partner can re-enroll for a certificate if it's in Active or Expired status. Re-enrollment is not permitted for terminated certificates.

• A certificate can automatically expire on its expiration date, changing its status to Expired.

This object contains the following attributes:

Field Name	Data Type	Description
id	string	The business identifier of the certificate. Example: CER-1234-5678-9012
href	string	The resource URI of the certificate. Example: /v1/program/certificates/CER-1234-5678-9012
program	object (program)	The program to which this certificate applies. Example: { "id": "PRG-1234-5678", "href": "/program/programs/PRG-1234-5678", "name": "Microsoft AI Cloud Partner" }
client	object (account)	The client or partner to whom the certificate belongs. Example: { "id": "ACC-1234-1222", "href": "/accounts/accounts/ACC-1234-1222", "name": "Oscorp Industries", "icon": "/static/ACC-1234-1222/account.png" }
applicableTo	string	Defines the scope in which the given enrollment has been created. Allowed values: buyer or licensee.
buyer	object	A reference to the buyer object if the enrollment applies to the buyer. Example: { "id": "BUY-1234-1234", "href": "v1/accounts/buyers/BUY-1234-1234", "name": "MPN EU" }
licensee	object	A reference to the licensee object if the enrollment applies to the licensee. Example: { "id": "CER-1234-1234", "href": "v1/accounts/licensees/LIC-1234-1234-1234" "name": "Stark Canada Limited", "externalId": "WW-CON-12345678" }
eligibility	eligibility	Configuration of the partner program. Example: { "client": true, "partner": false }
externalIds	externalIds	Identifier for the external system. Example: { "vendor": "ven-1233-3222" }
status	enum	The certificate's status. Allowed values: pending, updating, active, terminated, or expired.
expirationDate	dateTime	The expiration date of the certificate. When the date has passed, the system expires the certificate. Example: 2025-12-04
template	template	Example: { "id": "PTP-1234-4444", "href": "/programs/PRG-1234 1234/templates/TPP-1234-4444", "name": "Successful Activation" }
parameters.fulfillment	object (orderParameter)	An object that holds a concise definition of a parameter, its value, and any associated errors. Example: [ { "id": "PRM-1234-1234-1234", "name": "Tenant Id", "externalId": "tenant_id", "constraints": { "readonly": false, "hidden": true, "required": true, "unique": false }, "value": "69b73824-ce76-4866-ad47-b615ae9d8998", "error": { "id": "E001234", "message": "Incorrect parameter value" } } ]
parameters.ordering	object (orderParameter)	An object that holds a concise definition of a parameter, its value, and any associated errors. Example: [ { "id": "PRM-1234-1234-1234", "name": "Tenant Id", "externalId": "tenant_id", "constraints": { "readonly": false, "hidden": true, "required": true, "unique": false }, "value": "69b73824-ce76-4866-ad47-b615ae9d8998", "error": { "id": "E001234", "message": "Incorrect parameter value" } } ]
audit	object	A reference to the audit object.

Parameter value

This object contains the following attributes:

Field Name	Data Type	Description
id	string	The identifier of the parameter definition this value refers to. Example: PAR-1234-1234-1234
externalId	string	The ID of the parameter in the external system. Example: MPNID
type	string	The type of the parameter definition. Example: SingleLineText
name	string	The display name of the parameter. Example: Microsoft Partner Network ID
value	string	The value of the parameter. Example: 65272478BB01A12

Example response

{
  "id": "CER-1234-5678-9012",
  "href": "/v1/program/certificates/CER-1234-5678-9012",
  "program": {
    "id": "PRG-1234-5678",
    "href": "/program/programs/PRG-1234-5678",
    "name": "Microsoft AI Cloud Partner"
  },
  "certificant": {
    "id": "ACC-1234-1222",
    "href": "/accounts/accounts/ACC-1234-1222",
    "name": "Oscorp Industries",
    "icon": "/static/ACC-1234-1222/account.png"
  },
  "status": "Active",
  "parameters": {
    "fulfillment": [
      {
          "id": "PRM-1234-1234-1234",
          "name": "Tennant Id",
          "externalId": "tenant_id",
          "constraints": {
              "readonly": false,
              "hidden": true,
              "required": true,
              "unique": false
          },
          "value": "69b73824-ce76-4866-ad47-b615ae9d8998",
          "error": {
              "id": "E001234",
              "message": "Incorrect parameter value"
          }
      }
    ],
    "ordering": [
      {
          "id": "PRM-1234-1234-1234",
          "name": "Tennant Id",
          "externalId": "tenant_id",
          "constraints": {
              "readonly": false,
              "hidden": true,
              "required": true,
              "unique": false
          },
          "value": "69b73824-ce76-4866-ad47-b615ae9d8998",
          "error": {
              "id": "E001234",
              "message": "Incorrect parameter value"
          }
      }
    ]
  }
}