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.

Field
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

The program to which this certificate applies.

Example:

{
    "id": "PRG-1234-5678",
    "href": "/program/programs/PRG-1234-5678",
    "name": "Microsoft AI Cloud Partner"
}

client

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. Possible values: Buyer or Licensee.

buyer

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

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": "Rolls-Royce Canada Limited",
    "externalId": "WW-CON-12345678"
}

eligibility

eligibility

Configuration of the partner program.

Example:

{
  "client": true,
  "partner": false
}

externalIds

Identifier for the external system.

Example:

{
  "vendor": "ven-1233-3222"
}

status

string

The certificate's status.

Possible 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

Example:

{ 
  "id": "PTP-1234-4444", 
  "href": "/programs/PRG-1234 1234/templates/TPP-1234-4444",
  "name": "Succesful Activation" }

parameters.fulfillment

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

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

The audit information object.

Example:

{
  "created": { "at": "...", "by": { } },
  "updated": { "at": "...", "by": { } }
}

Parameter Value

Field
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

{
  "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"
          }
      }
    ]
  }
}

Last updated

Was this helpful?