Runs a certification test pack against a partner: every sample interchange

is validated (side-effect-free) against the partner’s implementation guide and checked against its expected outcome…

POST /v1/partners/{id}/certification/run

cURL

curl --request POST \
  --url 'https://edi.stateset.com/v1/partners/{id}/certification/run' \
  --header "Authorization: Bearer $STATESET_EDI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "cases": [
    {
      "description": "Two-person tent, green — replacement for damaged pole set.",
      "expect_valid": true,
      "name": "Two-Person Tent",
      "raw": "string"
    }
  ],
  "name": "Two-Person Tent"
}'

200

{
  "pack_name": "string",
  "partner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "passed": true,
  "passed_count": 1,
  "results": [
    {
      "actual_valid": true,
      "detail": "string",
      "expected_valid": true,
      "name": "Two-Person Tent",
      "passed": true
    }
  ],
  "total": 102
}

is validated (side-effect-free) against the partner’s implementation guide and checked against its expected outcome. When the pack passes and the partner’s onboarding is at the testing stage, it auto-advances to certified. Emits a signed edi.operator.certification_run audit event.

Path parameters

id · string · required

Partner ID

Request body

TestPack

cases · TestCase[] · required

name · string · required

Response

CertificationReport

pack_name · string · required

partner_id · string · required

passed · boolean · required

True only when every case passed.

passed_count · integer · required

results · CaseResult[] · required

Show CaseResult

actual_valid · boolean · required

detail · string

Why the validator reached its verdict — structural error or the first rejected document’s reason — surfaced so a failing case is debuggable.

expected_valid · boolean · required

name · string · required

passed · boolean · required

total · integer · required

Status codes

Code	Meaning
200	Certification report
403	Not this credential’s partner
404	Unknown partner
422	Invalid test pack

cURL

curl --request POST \
  --url 'https://edi.stateset.com/v1/partners/{id}/certification/run' \
  --header "Authorization: Bearer $STATESET_EDI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "cases": [
    {
      "description": "Two-person tent, green — replacement for damaged pole set.",
      "expect_valid": true,
      "name": "Two-Person Tent",
      "raw": "string"
    }
  ],
  "name": "Two-Person Tent"
}'

200

{
  "pack_name": "string",
  "partner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "passed": true,
  "passed_count": 1,
  "results": [
    {
      "actual_valid": true,
      "detail": "string",
      "expected_valid": true,
      "name": "Two-Person Tent",
      "passed": true
    }
  ],
  "total": 102
}