> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pr.snh-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Public Records API Reference

> Endpoint reference for the Public Records evaluation and identity matching APIs

## Base URL

All endpoints use a single base URL per environment. See [Environments](/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](/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:

```json theme={null}
{
  "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](/error-handling) for error response formats and [Retry Logic](/retry-logic) for retry strategy.