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

# Environments and API Keys

> Choose a Hum API environment, obtain the matching key, and verify access

# Environments and API Keys

Hum provides separate Sandbox and Production environments with the same API surface.

| Environment | Base URL | Purpose |
| - | - | - |
| Sandbox | `https://api-sandbox.letshum.com` | Integration development and testing |
| Production | `https://api.letshum.com` | Live traffic |

<Tip>
  Build and test your integration against Sandbox before switching to Production.
</Tip>

Sandbox serves the same national provider data set as Production, including the same data-set version. Use any real US address for testing; the example addresses in these docs work in Sandbox. An empty result means that no providers cover the address, just as it does in Production.

## Get an API Key

API keys are issued by Hum for each environment. There is no self-serve key dashboard. Request keys from your Hum contact or email [support@letshum.com](mailto:support@letshum.com).

Keys are environment-specific and visibly prefixed:

* Sandbox: `hum_sandbox_XXXXXXXXXXXXXXXXXXXXXXXXXX`
* Production: `hum_XXXXXXXXXXXXXXXXXXXXXXXXXX`

<Warning>
  A key works only in the environment that issued it. A Sandbox key cannot authenticate against Production, and a Production key cannot authenticate against Sandbox.
</Warning>

## Widget Environments

Use the bundle and key for the same environment:

| Environment | Widget bundle | Required key |
| - | - | - |
| Production | `https://cdn.letshum.com/widget.js` | Production key beginning with `hum_` |
| Sandbox | `https://cdn.letshum.com/widget-sandbox.js` | Sandbox key beginning with `hum_sandbox_` |

<Note>
  The hosted WebView page at `https://webview.letshum.com` loads the Production widget bundle, so it requires a Production key.
</Note>

## Verify Your Key

Use `GET /ping` as the first authenticated request:

```bash cURL theme={null}
curl https://api-sandbox.letshum.com/ping \
  -H "Authorization: Bearer hum_sandbox_XXXXXXXXXXXXXXXXXXXXXXXXXX"
```

```json Response theme={null}
{
  "message": "🎤 We're humming along!",
  "timestamp": "2026-07-13T16:26:17.874Z"
}
```

After this succeeds, continue with [API Integration](/api-integration).

## Postman

Prefer Postman? Import the ready-made collection. See [Postman Collection](/postman).

## API Reference Playground

The API Reference **Try it** playground defaults to the Sandbox server because Sandbox is listed first in the API specification. If you use a Production key without changing the server selector to Production, the request returns HTTP 401.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.