Skip to main content
Use GET /cyber-systems and GET /cyber-systems/ to read your BES Cyber Systems. Filtering by facility or control center is coming soon.
BES Cyber Systems (BCS) are the logical groupings of cyber assets that perform or support a reliable operation of the Bulk Electric System. In Raptor Comply, each cyber system is scoped to a facility or control center and carries an impact rating (High, Medium, or Low) that drives your CIP requirements. Use these endpoints to read your cyber system inventory and link it to asset management or SIEM workflows.
Every request to the Raptor Comply API requires the X-API-Key header. See Authentication for setup instructions.

​
Available endpoints

​
List all cyber systems

GET /cyber-systems Returns an array of all BES Cyber Systems belonging to your organization. Use this endpoint to load your full BCS inventory - for example, to pre-populate a system picker, reconcile against a CMDB, or feed a compliance dashboard.

​
Request

No path or query parameters are required. Include your authentication headers on every request. 
curl --request GET \
  --url https://api.raptormaps.com/cyber-systems \
  --header 'X-API-Key: YOUR_API_KEY'

​
Response

Returns 200 OK with a JSON array of cyber system objects.
​
id
string
Unique identifier for the cyber system, prefixed with cs_.
​
name
string
Human-readable name of the cyber system as configured in Raptor Comply, e.g. EMS BCS High.
​
facility_id
string
The unique identifier of the facility this cyber system belongs to. Use GET /facilities/{id} to look up facility details.
​
organization_slug
string
The slug of the organization that owns this cyber system.
[
  {
    "id": "cs_01DEF...",
    "name": "EMS BCS High",
    "facility_id": "fac_01HXY...",
    "organization_slug": "acme-utility"
  }
]

​
Get a single cyber system

GET /cyber-systems/{id} Returns a single BES Cyber System by its unique identifier. Use this endpoint to resolve a specific BCS - for example, after finding a cyber_system_id on a cyber asset record and needing the full system context.

​
Path parameters

​
id
string
required
The unique identifier of the cyber system, e.g. cs_01DEF.... You can obtain this value from the id field returned by GET /cyber-systems.

​
Request

curl --request GET \
  --url https://api.raptormaps.com/cyber-systems/cs_01DEF... \
  --header 'X-API-Key: YOUR_API_KEY'

​
Response

Returns 200 OK with a single cyber system object.
​
id
string
Unique identifier for the cyber system.
​
name
string
Human-readable name of the cyber system.
​
facility_id
string
The unique identifier of the facility this cyber system belongs to.
​
organization_slug
string
The slug of the organization that owns this cyber system.
{
  "id": "cs_01DEF...",
  "name": "EMS BCS High",
  "facility_id": "fac_01HXY...",
  "organization_slug": "acme-utility"
}

​
Coming soon

The following endpoints exist in the Raptor Comply API but are not yet available via API-key authentication. They are documented here so you can plan your integrations in advance. Subscribe to release notes to be notified when each batch becomes available.
The endpoints below are coming soon and are not yet accessible with your API key. Requests to these paths will not succeed. Check back for updates.

​
Create a cyber system

POST /cyber-systems Operation: createCyberSystem - Creates a new BES Cyber System in your Raptor Comply tenant.

​
Update a cyber system

PATCH /cyber-systems/{id} Operation: updateCyberSystem - Partially updates the properties of an existing BES Cyber System.

​
Delete a cyber system

DELETE /cyber-systems/{id} Operation: deleteCyberSystem - Permanently removes a BES Cyber System from your Raptor Comply tenant.

​
List cyber systems by facility

GET /facilities/{facilityId}/cyber-systems Operation: getCyberSystemsByFacility - Returns all BES Cyber Systems associated with the specified facility. Useful for scoped queries when you only need the BCS inventory for a single site.

​
List cyber systems by control center

GET /control-centers/{controlCenterId}/cyber-systems Operation: getCyberSystemsByControlCenter - Returns all BES Cyber Systems associated with the specified control center.