API Quality Report Finalizer

Validates and finalizes an API Quality Report, computes its canonical response hash, verifies telemetry observations, and prepares proof publishing on Arc Testnet. Only the configured hosted payer may settle this endpoint.

Example use case

The hosted Veyra workflow purchases final response hash attestation for an API Quality Report on Arc Testnet.

Agent reasoning hint

Use as the final step of Paid API Quality Report to finalize telemetry evaluation and bind canonical report hash to an Arc proof.

cURL example

Unpaid direct requests to live paid services return HTTP 402 until an agent satisfies the x402 payment requirement.

curl -i -X POST https://veyra-hzipm5uyh-mioku50s-projects.vercel.app/api/provider/api-quality-finalizer \
  -H 'Content-Type: application/json' \
  -d '{
  "report": {
    "kind": "api_quality_report"
  }
}'

Input schema

{
  "type": "object",
  "properties": {
    "report": {
      "type": "object"
    }
  },
  "required": [
    "report"
  ]
}

Output schema

{
  "type": "object",
  "properties": {
    "report": {
      "type": "object"
    },
    "paidAmountUsdc": {
      "type": "string"
    }
  },
  "required": [
    "report",
    "paidAmountUsdc"
  ]
}

Example request

{
  "method": "POST",
  "endpoint": "/api/provider/api-quality-finalizer",
  "body": {
    "report": {
      "kind": "api_quality_report"
    }
  }
}

Example response

{
  "report": {
    "kind": "api_quality_report",
    "verification": {
      "status": "verification_pending"
    }
  },
  "paidAmountUsdc": "0.0020"
}