Get Organization

Retrieves a single organization by its ID.

Endpoint

GET /api/organizations/:id

Authentication

Requires API Key authentication.

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Organization ID

Response

Returns the organization object.

{
  "success": true,
  "data": {
    "id": "org_abc123def456",
    "account_id": "acc_xyz789",
    "name": "Smith & Associates Law Firm",
    "phone_number": "555-123-4567",
    "street_address": "123 Main Street, Suite 400",
    "city": "San Francisco",
    "state": "CA",
    "zip_code": "94102",
    "country": "United States",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}

Example

curl -X GET "https://api.silentwitness.ai/api/organizations/org_abc123def456" \
  -H "X-API-Key: $API_KEY"

Errors

error_code	HTTP	error_type	Meaning
org_field_required	400	invalid_request_error	Organization ID is missing from the path.
org_not_found	404	invalid_request_error	No organization matches the provided ID.
org_access_denied	403	permission_error	The organization belongs to a different account.

Example Error

{
  "success": false,
  "error": "Organization not found",
  "error_code": "org_not_found",
  "error_type": "invalid_request_error",
  "error_param": "id",
  "request_id": "req_9c1b3a7e4d2f4a80a9b3e7c1f8d2a4b6"
}