Skip to content
UltimateTeam.ai Docs

Verify the SOC 2 evidence hash chain

POST
/api/v1/compliance/soc2/verify-chain
curl --request POST \
  --url https://api.ultimateteam.ai/api/v1/compliance/soc2/verify-chain \
  --header 'X-API-Key: <X-API-Key>'

Walks every artifact in the supplied window, recomputes each entry hash, and reports the first break (if any). Used by auditors to confirm the evidence has not been tampered with.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters”
start_date
Any of:
string format: date

Inclusive lower bound; defaults to 30 days ago

end_date
Any of:
string format: date

Inclusive upper bound; defaults to today

Responses

Section titled “ Responses ”

200

Section titled “200”

Successful Response

Media typeapplication/json
SOC2VerifyChainEnvelope

Typed envelope for POST /api/v1/compliance/soc2/verify-chain.

object
data
required
SOC2VerifyChainResponse

Response body for POST /api/v1/compliance/soc2/verify-chain.

object
broken_at
Any of:
string
error
Any of:
string
latest_hash
Any of:
string
verified
required
Verified

Number of artifacts checked

integer
meta
required
ResponseMeta

Standard metadata attached to every API response.

object
request_id
required
Request Id

Unique request identifier

string
timestamp
required
Timestamp

Server timestamp of the response

string format: date-time
Examplegenerated
{
  "data": {
    "broken_at": "example",
    "error": "example",
    "latest_hash": "example",
    "verified": 1
  },
  "meta": {
    "request_id": "example",
    "timestamp": "2026-04-15T12:00:00Z"
  }
}

422

Section titled “422”

Validation Error

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