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

# Environments

> Managing Sandbox, Staging, and Production deployments.

Nucleus maintains strict boundary separation between non-production sandboxes and live banking instances.

## Environment Endpoints

| Environment           | Base URL                                       | Purpose                                       |
| --------------------- | ---------------------------------------------- | --------------------------------------------- |
| **Production**        | `https://api.onnucleus.com/nucleus/api/v1`     | Live customer accounts, real money settlement |
| **Sandbox / Staging** | `https://sandbox.onnucleus.com/nucleus/api/v1` | Testing, UAT, simulated NIP switches          |
| **Local Development** | `https://localhost:8443/nucleus/api/v1`        | Offline engineering & integration debugging   |

***

## Test Data & Mock Switches in Sandbox

The Sandbox environment features built-in mocks for Nigerian banking infrastructure:

1. **Simulated BVN Engine:** Test BVNs (`22222222222`, `33333333333`) return deterministic KYC profiles for testing KYC Tiers 1 through 3 without incurring NIBSS verification fees.
2. **NIP Inbound / Outbound Simulator:** Inbound transfers sent to any generated test NUBAN credit the account instantly with simulated settlement entries.
3. **Credit Bureau Mock:** Returns pre-packaged credit history reports (Good Credit, High Arrears, Delinquent) based on the test client's external ID.

***

## Rate Limits

| Tier                                   | Read Requests    | Write / Financial Transactions |
| -------------------------------------- | ---------------- | ------------------------------ |
| **Sandbox**                            | 120 req / min    | 30 req / min                   |
| **Production (Unit / State MFB)**      | 1,000 req / min  | 300 req / min                  |
| **Production (Enterprise / National)** | 10,000 req / min | 2,500 req / min                |

If rate limits are exceeded, the server returns HTTP `429 Too Many Requests` with a `Retry-After` header indicating seconds until requests may resume.