> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getclean.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> getclean's own MCP server is at https://mcp.getclean.ai/mcp. The /mcp path of this docs site is Mintlify's search over these pages, not getclean.
> Every answer of the API opens with outcome. A page that could not be read is a record whose outcome says why, never an HTTP error; read outcome before anything else.
> The API's contract is the OpenAPI 3.1 file at https://docs.getclean.ai/openapi.yaml; the SDKs are generated from it.
> The product's name is written getclean, in lower case.

# Supplier certificates checked at the body that issued them

> Read the certificate that a supplier sends, and look its number up in the register of the body that issued it. The result says what the register states about the certificate, not what the PDF claims.

A buyer brings on 200 suppliers in 14 countries. Each sends a PDF of its certificates: quality management, organic production, a social audit. Anyone can change a PDF, and a PDF does not say what happened after its date. One supplier's certificate was withdrawn 8 months before, and another's covers a plant that the buyer does not buy from. This page builds a check that reads each certificate and then asks the body that issued it.

## The run in 4 steps

### Read the certificate into your fields

Upload the PDF with the fields of your supplier file as a template.

```json Fields sent with the file to upload_contents theme={"theme":"css-variables"}
{
  "json_schema": {
    "type": "object",
    "properties": {
      "certificate_number": { "type": "string" },
      "issuing_body": { "type": "string", "description": "The body that issued the certificate" },
      "holder": {
        "type": "string",
        "description": "The company the certificate was issued to, with its address"
      },
      "standard": { "type": "string", "description": "The standard that the certificate attests" },
      "scope": {
        "type": "string",
        "description": "The sites and the activities that the certificate covers"
      },
      "valid_until": {
        "type": "string",
        "description": "The last day of validity, as the certificate prints it"
      }
    }
  },
  "max_characters": 0
}
```

Each field comes back with the words it was taken from and their page. A certificate that is a scan is read from its picture, and each value then has a number for how sure the reading is.

### Look the number up at the issuing body

A certificate's number is searched as the scheme `registry`, with the code of the body that issued it. The catalog of datasources lists the bodies whose registers can be searched, each with its code. This search has no words: the number is looked up.

```json Request body of search theme={"theme":"css-variables"}
{
  "subject_identifiers": [
    { "scheme": "registry", "value": "CERTIFICATE_NUMBER", "issuer": "ISSUER_CODE" }
  ],
  "deterministic_only": true
}
```

Replace `CERTIFICATE_NUMBER` with the number from the certificate, and `ISSUER_CODE` with the issuing body's code from the catalog.

### Compare the register with the PDF

A result that matches the number says so, and it can have what the register declares about the item. This part of the result is cut to those 2 fields.

```json Part of the result theme={"theme":"css-variables"}
{
  "identifier_matches": [{ "scheme": "registry", "value": "CERTIFICATE_NUMBER", "issuer": "ISSUER_CODE" }],
  "declared": { "status": "withdrawn" }
}
```

The value of `status` is the register's own word. Fetch the register's page for the certificate, and fill the same 6 fields from it. Your agent then has 2 rows of one template, one from the PDF and one from the register, and each difference between them is a finding: another holder, another scope, another last day.

### Search for the supplier in its own languages

A register says whether a certificate is valid. It does not say what a local court or a local paper wrote about the plant. For that, search by the supplier's registry codes in the languages of its country, with the sources that are independent of the supplier first. The steps are in [Counterparty screening: what the company says, and what others say](https://docs.getclean.ai/use-cases/screening.md).

## What the head of procurement can check

| The head of procurement asks | What the check has |
| - | - |
| What does the certificate say? | Each field, with the words of the PDF and their page. |
| What does the issuing body say? | The register's entry for the number, as a record. |
| Where do the 2 differ? | The 2 rows of one template, field by field. |
| Was the register searched at all? | The receipt of the search, and a gap if the register could not be reached. |

## Know the limits

A search that finds nothing says that the datasources that were searched do not have the number. It is not proof of a forgery. The receipt names what was searched.

Not every certification body has a register that can be searched. The catalog says which have, and its codes are the only ones a search takes.

A model fills the fields from the PDF and from the register's page. Each value comes with the words it was taken from, and a person can read them.

For the calls, see [Find the exact paper, case, or company by its identifier](https://docs.getclean.ai/find/identifiers.md) and [Fill your fields, each with the words it came from](https://docs.getclean.ai/read/extract-fields-with-citations.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.