Me API Reference

Identify the organization your API key belongs to.

Overview: This endpoint returns the organization your API key is authenticated as. Use it to confirm which workspace a key maps to — for example, when verifying credentials during setup or surfacing the connected organization in your integration.
There is a single endpoint: fetch the current organization. There is no pagination, no filtering, and no parameters.

Get Current Organization

Returns the org_id and org_name of the organization tied to the API key in the request.

GET/api/external/me

Response Fields

Field	Type	Description
org_id	string	Unique identifier of the organization your API key belongs to.
org_name	string	Display name of the organization.

Code Examples

curl -X GET "https://api.hermon.io/api/external/me" \
  -H "x-api-key: sk_live_your_key_here"

Response Example

json

{
  "status": "success",
  "message": "Organization fetched successfully",
  "data": {
    "org_id": "org_2abc123def456",
    "org_name": "Acme Coaching"
  }
}

Error Responses

401Missing or invalid API key

json

{
  "status": "error",
  "message": "Invalid or revoked API key"
}

404Organization not found

json

{
  "status": "error",
  "message": "Resource not found"
}

429Rate limit exceeded

json

{
  "status": "error",
  "message": "Too many requests"
}