Join our pilot for displaying certified products in reseller webshops

It will now be easier to showcase certified IT products in reseller online shops. By participating in our pilot program for the GTIN API, you can test this newly developed solution free of charge before it becomes available to a broader audience.

If you have any questions, please contact Hannes Mäki.

In December 2024, we launched TCO Certified, Generation 10, and began collecting Global Trade Item Numbers (GTINs) for certified products. GTINs enable efficient product tracking and inventory management. We have now developed an API solution that allows resellers to retrieve GTIN data for certified products.

Join our pilot project

We are pleased to invite resellers to participate in our pilot program for testing our API solution. By participating in this initiative, you improve the visibility of certified products in online stores. Currently, GTINs are linked to more than 100,000 certified product models and configurations — a figure that is expected to rise during the coming months.

Benefits for resellers

Joining the pilot helps you meet the growing customer demand for sustainability. Highlighting certified products clearly communicates your commitment to sustainability while making it easier for buyers to make responsible product choices.

Some issues are expected

This is a pilot project, and the system is still under development. New GTINs are added continuously. While we strive to provide accurate information, we anticipate that issues will occur and cannot guarantee the accuracy or completeness of the information provided.

How to get started

To apply for an API key, please complete the form below. Make sure to read the terms and conditions before submitting your application. Once we have approved your request to join, we will contact you. You can then integrate the API into your web shop. The code your developers will need is available below.

Application

Terms and conditions

The GTIN API solution offered by TCO Development is a data-sharing service that provides information on the certification status of IT products. It is free of charge and provided “as is” without any guarantees regarding availability, accuracy, or performance.

1. Permitted use

The GTIN API solution allows resellers to mark IT products as certified according to TCO Certified in their online stores for end customers. Before it is implemented, resellers must first submit an application, which needs to be approved by TCO Development.

On each webpage where a certified product is displayed, the TCO Certified logo must be visible and include a link to tcocertified.com. (The logo can be downloaded at the bottom of this page.)

Information about TCO Certified may also be displayed next to the logo. Please find examples of how the information can be displayed below.

No other sustainability-related data may be displayed next to the TCO Certified logo in a way that implies endorsement, association, or verification by TCO Development.

The API may only be used to inform end customers about which IT products are certified according to TCO Certified. Any other use of the API or its data requires a separate written agreement with TCO Development.

2. Availability, accuracy and scope

While we strive to provide accurate information through the GTIN API solution, TCO Development makes no warranties — either expressed or implied — regarding the accuracy, completeness, or fitness of the data. TCO Development will not be liable for any direct or indirect damages resulting from the use of this service.

The API returns GTINs for most products with active TCO Certified, generation 10 certificates and some products with active TCO Certified, generation 9 certificates.

TCO Development reserves the right to modify, suspend, or discontinue the service at any time without prior notice.

3. Data updates

Users of the GTIN API solution are responsible for ensuring that the information displayed to end customers is accurate and up to date. Updates are required at least once a month.

4. Prohibited uses

Users of the GTIN API solution and its data must not do any of the following:

  • Imply, suggest, or promote a partnership, endorsement, or cooperation with TCO Development without prior written agreement.
  • Use the service or any related materials in a way that could be considered misleading to customers (e.g., greenwashing and bluewashing).
  • Make an unreasonable volume of requests to the API that could negatively impact the service’s availability, stability, or performance.
  • Share, misuse, or fail to adequately protect any API login keys provided by TCO Development.
5. Misuse and termination

TCO Development reserves the right to suspend or terminate a user’s access to the GTIN API solution without prior notice if it is misused, including but not limited to violations of these terms and conditions.

6. Updates to the terms and conditions

TCO Development reserves the right to update or modify these terms and conditions at any time. The latest version will be published on our industry website.

Continued use of the GTIN API solution after updates indicates acceptance of the revised terms and conditions. If a user does not accept the updated terms, they must immediately remove the API from their website(s).

Documentation

This API provides access to a list of GTINs (Global Trade Item Numbers) for products certified with TCO Certified, optionally in JSON-LD format.

Authentication

Before accessing the API, you must authenticate and retrieve a token.

Token Endpoint

bash
POST https://api.tcocertified.com/token

Request Body

json
{
"username": "YOUR_API_USER",
"password": "YOUR_API_KEY"
}

Replace YOUR_API_KEY and YOUR_API_USER with the actual credentials received on an approved application

Example Response

json
{
"result": "ok",
"token": "your-access-token",
"validUntil": "2025-06-25T16:41:41Z"
}

Use this token in subsequent API calls as a Bearer token in the X-Auth-Token header.

Endpoint: Retrieve Certified Product GTINs

http

POST https://api.tcocertified.com/generic/gtin

Description: Retrieves a paginated list of GTINs for products certified with TCO Certified. Results can be returned in JSON-LD if requested.

Request Details

Header
X-Auth-Token
Content-Type
Value
Bearer your-access-token
application/json (if body used)
Required
Yes
Optional if no body

Query Parameters (in JSON body)

Parameter
product_type
page
jsonld

Type
string
int
bool

Description
(Optional) Filter by certified product type. See Available Types.
(Optional) Page number for pagination. If omitted, the page starts at 1. Page size is set to 200 products.
(Optional) Set to true to return data in JSON-LD format.

Example request

cURL

curl --location --request POST 'https://api.tcocertified.com/generic/gtin'
--header 'X-Auth-Token: Bearer your-access-token'
--header 'Content-Type: application/json'
--data '{
"product_type": "Displays",
"page": 1,
"jsonld": true
}'

Example response

{
"id": "urn:uuid:36243BD7-84BF-C443-864E-CFB059FE0468",
"issueDate": "2025-06-27",
"issuer": "TCO Development",
"products": [
{
"certificationInfo": {
"agency": "TCO Development",
"agencyURL": "https://tcocertified.com/",
"certificateId": "D123456789",
"endDate": "2026-12-04",
"id": "https://tcocertified.com/product-finder/?cert=D123456789",
"program": "TCO Certified",
"standard": "TCO Certified, generation 10, for displays",
"startDate": "2024-12-04",
"status": "ACTIVE",
"type": "CertificationDetails"
},
"gtin": "01234567891234",
"id": "https://id.gs1.org/01/01234567891234",
"name": "ABC Display 123",
"type": "Product"
}
] }

Available Product Types

These values are case-sensitive and must match exactly as shown.

  • All-in-one PCs
  • Desktops
  • Displays
  • Headsets
  • Notebooks
  • Projectors
  • Servers
  • Smartphones
  • Tablets

Visual guide

By following these guidelines for displaying the certification status on your website, you will ensure that you meet our terms and conditions. The page must include a link to tcocertified.com.

Longer version

Shorter version

TCO Certified is the global sustainability certification for IT products, empowering both IT buyers and brands to make more responsible choices. The comprehensive criteria are designed to drive social and environmental responsibility and are updated continuously to push sustainability where it matters most. Compliance with all criteria is always independently verified for every product.

Learn more

 

 

 

 

 

 

 

 

TCO Certified is the global sustainability certification for IT products, empowering both IT buyers and brands to make more responsible choices.

Learn more

TCO Certified is the global sustainability certification for IT products, empowering both IT buyers and brands to make more responsible choices.

Learn more