Reference / Os Access

List the application's enrolled hosts, newest first.

GET /v1/os/hosts
Secret API key operationId: list_hosts

Authorization

Server-to-server. Send a secret key as a Bearer token plus the x-application-id header.

Responses

200 Hosts
{
  "data": [
    {
      "enrolled_at": "2026-01-15T09:30:00Z",
      "facts": {},
      "host_group_id": "018f3c4a-7b2e-7c1d-9e0a-1f2b3c4d5e6f",
      "hostname": "string",
      "id": "018f3c4a-7b2e-7c1d-9e0a-1f2b3c4d5e6f",
      "join_state": "string",
      "last_seen_at": "2026-01-15T09:30:00Z",
      "machine_key": "string",
      "platform": "string",
      "revoked_at": "2026-01-15T09:30:00Z",
      "status": "string"
    }
  ],
  "error": {
    "code": "string",
    "message": "string"
  },
  "meta": {
    "timestamp": "string"
  },
  "success": false
}

Request

curl -X GET "https://api.identrahq.com/v1/os/hosts" \

Try it

live request
GET https://api.identrahq.com/v1/os/hosts