Skip to content
Hyperproof API
/
/
Test Results API

Test Results API (1.0)

Provides access to the test results within a Hyperproof organization.

Download OpenAPI description
testresults.openapi.json
testresults.openapi.yaml
Languages
Servers
Mock server
https://developer.hyperproof.app/_mock/hyperproof-api/test-results/testresults.openapi
Hyperproof US
https://api.hyperproof.app/v1/testresults
Hyperproof Gov
https://api.hyperproofgov.app/v1/testresults
Hyperproof EU
https://api.hyperproof.eu/v1/testresults

Get Most Recent Test Results

Request

GET /testresults/mostrecent?outcome={outcome}

Description

Returns full details of the most recent test results that match the specified filter criteria, including outcomes, timestamps, and associated objects.

Security
oauth2
Query
outcomestringrequired

Filters results by the provided test outcome

Enum"passed""failed""needsReview""inRemediation""resolved"
testParentObjectTypestring

Filters by object type that the test whose results are being returned is created on.

Enum"control""label""controlScope"
limitinteger[ 1 .. 500 ]

The maximum number of test results to return per page.

Default 50
nextTokenstring

Token returned from a previous call to retrieve test results.

curl -i -X GET \
  'https://developer.hyperproof.app/_mock/hyperproof-api/test-results/testresults.openapi/mostrecent?outcome=passed&testParentObjectType=control&limit=50&nextToken=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success.

Bodyapplication/json
dataArray of objects(TestRunResult)

The data in the test run results.

Example: [{"testId":"123e4567-e89b-12d3-a456-426614174000","testRunId":"123e4567-e89b-12d3-a456-426614174001","outcome":"passed","testParentObjectType":"controlScope","testParentObjectId":"123e4567-e89b-12d3-a456-426614174002","testCases":[{"$ref":"#/components/schemas/TestCaseResult"}]}]
nextTokenstring

The token for the next page of test run results.

Response
application/json
{
  "data": [
    { … }
  ],
  "nextToken": "string"
}
® 2026 Hyperproof All Rights Reserved.