Skip to main content

Update VMC order

PUT https://www.digicert.com/services/v2/order/certificate/{{order_id}}/vmc

Use this endpoint to update the logo data for a pending Verified Mark Certificate order, and to change the hosting settings for a pending or issued order.

Important

Changing the logo data updates this data for all pending orders using the same logo.

Example requests and responses

Example 1. cURL
curl --request PUT 'https://www.digicert.com/services/v2/order/certificate/144457106/vmc' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mark_type_data": {
      "country_code": "au",
      "registration_number": "C1234-D1234"
    }
}'

Path parameters

Name

Req/Opt

Description

order_id

required

Verified Mark Certificate order ID.

Request parameters

Name

Req/Opt

Type

Description

enable_hosting

optional

bool

If true, DigiCert hosts the image and certificate files. Otherwise, false (default).

When image and certificate file hosting is enabled, the Order info endpoint returns the location of the hosted files in the hosted_logo_location and hosted_cert_location response parameters.

Learn more about VMC image and file hosting.

mark_type_data

Object with details about the logo the certificate secures.

.. country_code

Two-letter country code. For government marks, identifies the country or region that grants you rights to use the logo. For registered trademarks, identifies the country or region where the logo is registered.

For government marks, when you provide a citation value, you must also provide a country_code.

Allowed values: See Glossary – Trademark offices and country codes for VMC logos

.. state_province

For government marks, state or province that grants you the rights to use the logo. Ignored for registered trademarks.

.. locality

For government marks, the locality that grants you the rights to use the logo. Ignored for registered trademarks.

.. citation

For government marks, identifier for the law, statute, or citation that grants you the rights to use the logo. Ignored for registered trademarks.

.. registration_number

For registered trademarks, the trademark registration number for the logo. Ignored for government marks.

trademark_country_code

Deprecated*

optional

string

Two-letter code for the country or region where the logo is trademarked.

Allowed values: See Glossary – Trademark offices and country codes for VMC logos

*Deprecated: DigiCert has deprecated the trademark_country_code request parameter. Use mark_type_data.country_code, instead. Learn more about this change.

trademark_registration_number

Deprecated*

optional

string

Trademark registration number of the logo.

*Deprecated: DigiCert has deprecated the trademark_registration_number request parameter. Use mark_type_data.registration_number, instead. Learn more about this change.

In this section: