# 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 NameData TypeDescription
idstring

The business identifier of the certificate.

Example: CER-1234-5678-9012

hrefstring

The resource URI of the certificate.

Example: /v1/program/certificates/CER-1234-5678-9012

programobject (program)

The program to which this certificate applies.

Example:

{
    "id": "PRG-1234-5678",
    "href": "/program/programs/PRG-1234-5678",
    "name": "Microsoft AI Cloud Partner"
}
clientobject (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"
}
applicableTostringDefines the scope in which the given enrollment has been created. Allowed values are buyer or licensee.
buyerobject

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"
}
licenseeobject

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"
}
eligibilityeligibility

Configuration of the partner program.

Example:

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

Identifier for the external system.

Example:

{
  "vendor": "ven-1233-3222"
}
statusenumThe certificate's status. Allowed values are pending, updating, active, terminated, or expired.
expirationDatedateTime

The expiration date of the certificate. When the date has passed, the system expires the certificate.

Example: 2025-12-04

templatetemplate

Example:

{ 
  "id": "PTP-1234-4444", 
  "href": "/programs/PRG-1234 1234/templates/TPP-1234-4444",
  "name": "Successful Activation" 
}
parameters.fulfillmentobject (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.orderingobject (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"
      }
  }
]
auditobjectA reference to the audit object.
## Parameter value This object contains the following attributes:
Field NameData TypeDescription
idstring

The identifier of the parameter definition this value refers to.

Example: PAR-1234-1234-1234

externalIdstring

The ID of the parameter in the external system.

Example: MPNID

typestring

The type of the parameter definition.

Example: SingleLineText

namestring

The display name of the parameter.

Example: Microsoft Partner Network ID

valuestring

The value of the parameter.

Example: 65272478BB01A12

## Example response {% code lineNumbers="true" %} ```json { "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" } } ] } } ``` {% endcode %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.platform.softwareone.com/developer-resources/rest-api/program-api/certificate.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.