Order Mark Certificate via API

Apr 27, 2026

OVERVIEW: This page walks you through the process of ordering GlobalSign's Mark Certificates via API. GlobalSign offers a Simple Object Access Protocol (SOAP) API for its partners and customers to directly order and manage certificates. Through this API, partners can perform functions such as ordering the following Mark Certificate types: Verified Mark, Common Mark, Modified Mark and Government Mark. For more Mark Certificates API guides, please refer to this page.

Mark Certificates are digital security certificates utilized in email communications to verify the sender's identity and display the organization’s official brand logo within the recipient's inbox. These certificates play an essential role in the BIMI (Brand Indicators for Message Identification) standard, acting as a formal confirmation that a logo is associated with a legitimate organization.

There are four types of Mark Certificates:

  1. Verified Mark Certificate (VMC)

    The Verified Mark Certificate is widely regarded as the benchmark for brand authentication. Organizations seeking a VMC must demonstrate ownership of a legally registered trademark for their logo within an approved jurisdiction.

    Key Feature: This is currently the sole certificate that enables display of the blue verified checkmark in Gmail.
  2. Common Mark Certificate (CMC)

    The Common Mark Certificate provides a more accessible alternative by allowing organizations to showcase a logo without a registered trademark, provided they can establish that the logo has been in public use for a minimum of 12 months (Prior Use Mark).

    Key Feature: Permits the brand logo to appear in recipients’ inboxes but does not provide the blue verified checkmark in Gmail.
  3. Modified Mark Certificate (MMC)

    Mark Certificate is typically considered a sub-type of the Common Mark Certificate (specifically, a Modified Registered Mark).

    Key Feature: Enables brands to utilize slightly modified versions of their trademarked logo—such as adaptations for limited screen size or seasonal themes—while retaining a cryptographic link to the original registered trademark.

    Validation: Documentation must confirm that the modified logo is a legitimate derivative of a valid registered mark.
  4. Government Mark Certificate (GMC)

    Reserved for government agencies and departments, the Government Mark Certificate authorizes the display of official government seals or agency logos.

    Key Feature: Provides authorized government entities with the same visual advantages as a VMC, including the blue verified checkmark in Gmail.

    Validation: Verification is based on official granting via statute, regulation, treaty, or other formal governmental action.

Product Code Product Name Use in Order Request
VMC  Verified Mark Certificates Use VMC in Order Request for Verified Mark Certificates
GMC  Government Mark Certificates Use GMC for Government Mark Certificates
CMC Common Mark Certificates Use CMC for Common Mark Certificates
MMC Modified Registered Mark Certificates Use MMC for Modified Registered Mark Certificates

 

Function API Request
Place Mark Certificate Order MarkOrder
Validate SVG file as per BIMI Compliance ValidateLogo
Add or update SANs for orders ChangeSubjectAltName
Obtain Service Agreements for Mark Certificate requests. GetAgreement
Obtain certificate as either a PEM-encoded chain file GetCertPEMfile
Retrieve comprehensive information regarding Mark Certificates GetOrderbyOrderID
Obtain the order request form for customer’s consent GetRequestform
Revoke certificate Revoke Order

To learn more about these requests and field descriptions, see Mark Certificates API Requests guide.

Type Feature URL
Prod Mark Functions WSDL https://system.globalsign.com/kb/ws/v1/MarkService?wsdl
Test Mark Functions WSDL for Testing purposes only https://test-gcc.globalsign.com/kb/ws/v1/MarkService

PREREQUISITE

To get test credentials, request a test account from your GlobalSign Account Manager or Support team.

 

Type Feature URL
Prod Mark Functions https://system.globalsign.com/kb/ws/v1/MarkService

Prerequisite

  1. User should have GCC Account created and has valid credentials i.e. username and password.

    1. Contact your account manager for GCC Account creation.

    2. User should have SVG file converted to Base64 for start placing and validating Mark SVGs files.

  2. The APIs require the user's IP address to be whitelisted. Contact your GlobalSign Account Manager or support team.

MarkOrder Request

MarkOrder Request will help you create the order. Below is the structure and the parameters which should be supplied for creating an order.

Fields Description

Field

Condition

Definition

<UserName>

Required

Input your user ID this is same for your GCC User Interface

<Password>

Required

Input your password this is same for your GCC User Interface

<ProductCode>

Required

See section 2 and basis the same you can add Product Code like MMC, VMC, GMC, CMC

<OrderKind>

Required

New / Renewal: indicates the order type

<Licenses>

Required

1 : as this Retail certificates so this depicts the license number as 1.

<ValidityPeriod><Months></Months></ValidityPeriod>

Required

The number of months that a certificate will be valid for. Set it to 12.

<SvgLogoBase64>

Required

For all mark types. Provide the base64 file of the SVG you want to use in your certificate.

<MarkLicenseExpiryDate>

Optional

Please select input the date of the license expiry of your Trademark. If you are not sure, then please leave this blank. Our vetting team will find this out for you.

<TrademarkIdentifier>

Optional

For VMC and MMC only. Enter the trademark license identifier/unique license number.

<TrademarkCountryOrRegionName>

Required

For VMC and MMC only. Enter the Two Digit Country code.

<TrademarkOfficeName>

Required

For VMC and MMC only. Select the trademark office where your trademark logo is registered.

<CommonNameSAN>

Required

For alL Mark Type. Enter your domain name like example.com

<Organization>

Required

Enter the organization name.

<Locality>

Optional

Enter the locality name

<StateOrProvince>

Optional

 

<Country>

Required

Enter the Two Digit Country code.

<ContactInfo>
<FirstName></FirstName> <FirstNameNative</FirstNameNative>
<LastName></LastName> <LastNameNative</LastNameNative>
<Phone></Phone>
<Email></Email> <OrganizationNameNative>
</OrganizationNameNative>
</ContactInfo>

Required
1. <FirstName>
2. <LastName>
3. <Phone>
4. <Email>

Primary Contact Information of for a certificate request

<Coupon>

Optional

Coupons can be used for payment

<Campaign>

Optional

Campaign can be used for payment

<StatuteCitation>

Optional

For GMC only. If you have some reference link that you can provide for the reference that can help us identify the legal status of the logo being used i.e. some legal statue reference or article. If not sure, leave it blank.

<StatuteLocalityName> Optional For GMC only. Enter the locality name

<StatuteStateOrProvinceName>

Optional

For GMC only. Enter the state or province name

<StatuteCountryName>

Optional

For GMC only. Enter the country name

<PriorUseMarkSourceURL>

Optional

For CMC only. If you are sure of the archive URL of the logo display from past 12 months then please enter it here.

<SecondContactInfo>

<FirstName></FirstName>

<LastName></LastName>
       <Email></Email>
   </SecondContactInfo>

Optional

Secondary contact for this order.

<SANEntries> <SANEntry>
<SANOptionType>
      </SANOptionType>
<SubjectAltName>
</SubjectAltName>
</SANEntry>
</SANEntries>

Optional

<SANEntries> parameters should be set to what the SubjectAltName(s) will be after the change. GlobalSign will do a manual review of the change for Mark Certificates. New certificates with updated SANs will be issued and queriable after vetting has been completed.

<OrganizationInfoEV>
<BusinessAssumedName>?

</BusinessAssumedName>
<CreditAgency>?
</CreditAgency>
<OrganizationCode>?
</OrganizationCode>

<OrganizationNameNative>
</OrganizationNameNative>

<BusinessCategoryCode>?

</BusinessCategoryCode>
<OrganizationAddress>
<AddressLine1>?
</AddressLine1>
<AddressLine1Native>?
</AddressLine1Native>
<AddressLine2>?
</AddressLine2>
<AddressLine2Native>?
</AddressLine2Native>
<AddressLine3>?
</AddressLine3>
<City>?</City>
<CityNative>?
</CityNative>
<Region>?
</Region>
<RegionNative>?
</RegionNative>
<PostalCode>?
</PostalCode>
<Country>?
</Country>
<Phone>?
</Phone>
<Fax>?
</Fax>
</OrganizationAddress>
</OrganizationInfoEV>

Required
1. </AddressLine1>
2. <AddressLine2>
3. <AddressLine3>
4. <City>
5. <PostalCode>
6. <Country>
7. <Phone>

Organization Info sent with Certificate request.

<RequestorInfo>

<FirstName>?</FirstName>
<FirstNameNative>
</FirstNameNative>

<LastName>?</LastName>
<LastNameNative>
</LastNameNative>

<Function>?</Function>
<OrganizationName>
</OrganizationName>

<OrganizationNameNative>

</OrganizationNameNative>

<OrganizationUnitNative>

</OrganizationUnitNative>
<Phone>?</Phone>
<Email>?</Email> </RequestorInfo>

Required
1. <OrganizationName>
2. <FirstName>
3. <LastName>
4. <Phone>
5. <Email>

A Certificate Requester is a natural person who is Applicant, employed by Applicant, or an authorized agent who has express authority to represent Applicant or a third party (such as an ISP or hosting company) that completes and submits a Certificate Request on behalf of Applicant.

<ApproverInfo>
<FirstName>?</FirstName>
<FirstNameNative>
</FirstNameNative>
<LastName>?</LastName>
<LastNameNative>?
</LastNameNative>
<Function>?</Function>
<OrganizationName>
</OrganizationName>
<OrganizationNameNative>
</OrganizationNameNative>
<OrganizationUnitNative>
</OrganizationUnitNative>
<Phone>?</Phone>
<Email>?</Email>
</ApproverInfo>

Required
1. <OrganizationName>
2. <FirstName>
3. <LastName>
4. <Phone>
5. <Email>

A Certificate Approver is a natural person who is Applicant, employed by Applicant, or an authorized agent who has express authority to represent Applicant to (i) act as a Certificate Requester and to authorize other employees or third parties to act as a Certificate Requester, and (ii) to approve Certificate Requests submitted by other Certificate Requesters.

<AuthorizedSignerInfo>
<OrganizationName>?
</OrganizationName>
<OrganizationNameNative>
</OrganizationNameNative>
<FirstName>?</FirstName>
<FirstNameNative>
</FirstNameNative>
<LastName>?</LastName>
<LastNameNative>
</LastNameNative>
<Function>?</Function>
<OrganizationUnitNative>
</OrganizationUnitNative>
<Phone>?</Phone>
<Email>?</Email>
</AuthorizedSignerInfo>

Required
1. <OrganizationName>
2. <FirstName>
3. <LastName>
4. <Phone>
5. <Email>

A Contract Signer is a natural person who is Applicant, employed by Applicant, or an authorized agent who has express authority to represent Applicant who has authority on behalf of Applicant to sign Subscriber Agreements on behalf of Applicant.

<JurisdictionInfo>
<JurisdictionCountry>
</JurisdictionCountry>
<JurisdictionState>
</JurisdictionState>
<JurisdictionLocality>
</JurisdictionLocality>
<IncorporationAgency
RegistrationNumber>
</IncorporationAgency
RegistrationNumber>
</JurisdictionInfo>

Required
1. <JurisdictionCountry>

Jurisdiction of Incorporation Details.

     
     
     

 

TrademarkCountry and Office List

 

For TrademarkCountryOrRegionName, please refer to the two-digit ISO codes as outlined in the document available at: https://www.wipo.int/documents/d/standards/docs-en-03-03-01.pdf. Regarding the TrademarkOffice List, we are providing a selection of some of the most frequently used and prominent offices for your reference, please refer to this page.

 

GlobalSign System Alerts

View recent system alerts.

View Alerts

Atlas Discovery

Scan your endpoints to locate all of your Certificates.

Sign Up

SSL Configuration Test

Check your certificate installation for SSL issues and vulnerabilities.

Contact Support