Skip to content
Mintall

Verify a product certificate

POST
/mc4p/products/{product_id}/verify
curl --request POST \
  --url https://api.mintall.ai/api/v1/mc4p/products/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/verify \
  --header 'Content-Type: application/json' \
  --data '{ "productUrl": "example", "document": { "productID": "example", "url": "example", "mintall:issuedFor": { "domain": "example", "productID": "example" }, "proof": { "jwt": "example" } } }'

Verify that the product certificate is authorized for the requesting domain.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
product_id
required
Product Id
string format: uuid

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
ProductVerificationRequest

Request body for product certificate verification.

object
productUrl
required
Producturl
string
document
Any of:
SubmittedProductDocument

The MC4P product document as a verifier found it on a page.

proof present means a full document (the signature checks run). proof absent means an identity-only document. Unknown keys are ignored so any serialization of the document validates.

object
productID
Any of:
string
url
Any of:
string
mintall:issuedFor
Any of:
IssuedFor

Binds the document to the platform’s own Product node.

object
domain
Any of:
string
productID
Any of:
string
proof
Any of:
SubmittedProof
object
jwt
required
Jwt
string
Examplegenerated
{
  "productUrl": "example",
  "document": {
    "productID": "example",
    "url": "example",
    "mintall:issuedFor": {
      "domain": "example",
      "productID": "example"
    },
    "proof": {
      "jwt": "example"
    }
  }
}

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
ProductVerificationResponse
object
status
required
Status
string
Allowed values: verified failed unverified
productId
required
Productid
string
issuedFor
Any of:
string
checks
required
ProductVerificationChecksResponse

Per-check verification results.

None means the check was not evaluated for this request (for example the signature checks when no document was submitted), as opposed to False, which means the check ran and failed. Agents reading this response must not treat skipped checks as failures.

object
domainKnown
Any of:
boolean
domainVerified
Any of:
boolean
boundToUrl
Any of:
boolean
boundToDomain
Any of:
boolean
productIdMatches
Any of:
boolean
signatureValid
Any of:
boolean
certificateIntegrity
Any of:
boolean
trustDataCurrent
Any of:
boolean
timestampValid
Any of:
boolean
warnings
required
Warnings
Array<string>
errors
required
Errors
Array<string>
Example
{
  "status": "verified"
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object
Examplegenerated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}