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:
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 |
User should have GCC Account created and has valid credentials i.e. username and password.
Contact your account manager for GCC Account creation.
User should have SVG file converted to Base64 for start placing and validating Mark SVGs files.
The APIs require the user's IP address to be whitelisted. Contact your GlobalSign Account Manager or support team.
MarkOrder Request will help you create the order. Below is the structure and the parameters which should be supplied for creating an order.
|
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> |
Required |
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> |
Optional |
Secondary contact for this order. |
|
<SANEntries> <SANEntry> |
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> |
Required |
Organization Info sent with Certificate request. |
|
<RequestorInfo> |
Required |
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> |
Required |
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> |
Required |
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> |
Required |
Jurisdiction of Incorporation Details. |
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.
Check your certificate installation for SSL issues and vulnerabilities.