Connectivity API
API connectivity check
Returns the organization ID associated with the API key. Call it with a GET request to /ping, authenticated with a restricted API key.
GET https://api.bearlumen.com/v1/ping
Returns the organization ID associated with the API key. Use this to verify your API key and connectivity before sending events. Requests count toward your per-API-key rate limit; sustained overruns return 429 with the standard error envelope.
Authentication and scopes
Authenticate with a restricted API key in the Authorization: Bearer <key> header. No additional scope is required.
Response example
Success response (200):
{
"ok": true,
"organization_id": "b7e6a3f2-4c1d-4e8a-9b5f-2d7c8e1a6f43"
}
Error codes
Errors return the standard error envelope with a code, message, and a correlationId you can quote to support.
| Status | When it happens |
|---|---|
401 | Missing or invalid API key. Send your key as Authorization: Bearer YOUR_API_KEY. |
429 | Rate limit or plan quota exceeded. Slow down and retry after the current window resets. |
Rate limits and retries
Rate limit or plan quota exceeded. Slow down and retry after the current window resets.