Public Records API Reference

Base URL

All endpoints use a single base URL per environment. See Environments for staging and production URLs.

https://cra.pr.snh-ai.com

Authentication

All endpoints except /health require a JWT Bearer token in the Authorization header. See Authentication for the full flow.

Authorization: Bearer YOUR_JWT_TOKEN

Endpoints

Endpoint	Method	Description	Auth Required
`/health`	`GET`	Service health and status	No
`/auth/token`	`POST`	Exchange API key for JWT token	API Key
`/evaluate`	`POST`	Evaluate a single criminal record	Bearer Token
`/complianceEngine/identity-match`	`POST`	Standalone identity comparison	No

Response Envelope

All responses use a standard { success, data, meta } envelope:

{
  "success": true,
  "data": { ... },
  "meta": {
    "api_version": "2.0.0",
    "process_time_ms": 1855,
    "correlation_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Field	Description
`success`	`true` on HTTP 200/206, `false` on errors
`data`	Service-specific response payload
`meta.api_version`	API version string
`meta.process_time_ms`	Server-side processing time in milliseconds
`meta.correlation_id`	Unique request ID — include when contacting support

HTTP Status Codes

Code	Meaning
`200`	Success
`206`	Partial success — some processing failed, results still returned
`400`	Bad request — invalid parameters
`401`	Unauthorized — missing or invalid authentication
`422`	Validation error
`500`	Server error

See Error Handling for error response formats and Retry Logic for retry strategy.

​Base URL

​Authentication

​Endpoints

​Response Envelope

​HTTP Status Codes

Base URL

Authentication

Endpoints

Response Envelope

HTTP Status Codes