SDKs

The SDKs call the same operations that the MCP server exposes.

TypeScript

TypeScript is handed over as a tarball made with npm pack; it is not installed from npm. Its default base URL is https://api.acretix.io.

Read the key from ACRETIX_API_KEY and pass it to the constructor. The constructor accepts only an avk_... key.

new AcretixVerify({ apiKey: process.env.ACRETIX_API_KEY ?? '' })

TypeScript SDK methods and the API operation each calls
Method	API operation
`compileRubric`	`POST /api/v1/rubrics`
`submitVerification`	`POST /api/v1/verify`
`getVerification`	`GET /api/v1/verifications/{verification_id}`
`getRubric`	`GET /api/v1/rubrics/{rubric_id}`
`waitForVerification`	`GET /api/v1/verifications/{verification_id}`
`getProof`	`GET /api/v1/verifications/{verification_id}/proof`
`reverify`	`POST /api/v1/verifications/{verification_id}/reverify`
`getUsage`	`GET /api/v1/usage`
`submitFeedback`	`POST /api/v1/verifications/{verification_id}/feedback`

verifyWebhook(rawBody, signatureHeader, secret, options?)

Pass the raw request body exactly as received, before any JSON parsing.

Failures throw AcretixWebhookError with one of these reasons:

See Webhooks for the events, the signature header, and the retries.

Python is handed over as a wheel built with python -m build; it is not installed from PyPI. Its default base URL is https://api.acretix.io.

Read the key from ACRETIX_API_KEY and pass it to the constructor. The constructor accepts only an avk_... key.

AcretixVerify(os.environ["ACRETIX_API_KEY"])

Python SDK methods and the API operation each calls
Method	API operation
`compile_rubric`	`POST /api/v1/rubrics`
`submit_verification`	`POST /api/v1/verify`
`get_verification`	`GET /api/v1/verifications/{verification_id}`
`get_rubric`	`GET /api/v1/rubrics/{rubric_id}`
`wait_for_verification`	`GET /api/v1/verifications/{verification_id}`
`get_proof`	`GET /api/v1/verifications/{verification_id}/proof`
`reverify`	`POST /api/v1/verifications/{verification_id}/reverify`
`get_usage`	`GET /api/v1/usage`
`submit_feedback`	`POST /api/v1/verifications/{verification_id}/feedback`

verify_webhook(raw_body, signature_header, secret, tolerance_seconds=300, now=None)

Pass the raw request body exactly as received, before any JSON parsing.

Failures raise AcretixWebhookError with one of these reasons:

See Webhooks for the events, the signature header, and the retries.