SaaS App and Device Management APIs

APIs to monitor and manager integrations

Fetch Github repositories

get

Returns a list of repositories Nightfall has access to.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

limitinteger · min: 1 · max: 100Optional

The maximum number of records to be returned in the response

Default: 100

pageTokenstringOptional

Cursor for getting the next page of results

Responses

200

Successful response

application/json

400

Invalid request parameters

application/json

401

Authentication failure

application/json

429

Rate Limit Exceeded or Daily Quota Exceeded

application/json

500

Internal Nightfall Error

application/json

get

/github/repositories

HTTPcURLJavaScriptPython

GET /apps/v1/github/repositories HTTP/1.1
Host: api.nightfall.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "repositories": [
    {
      "repositoryID": 1,
      "repositoryName": "text",
      "isRepoPrivate": true,
      "repoLink": "text",
      "scannedAt": 1,
      "isMonitored": true,
      "githubUsername": "text"
    }
  ],
  "nextPageToken": "text"
}

List endpoint devices

get

Returns a list of endpoint devices where the Nightfall agent is installed across the organization.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

limitinteger · min: 1 · max: 500Optional

The maximum number of agents to be returned in the response

Default: 500

pageTokenstringOptional

Cursor for getting the next page of results

querystringOptional

Prefix search across device name, device ID, and user email

agentVersionstring · enumOptional

Filter agents by version status

Possible values:

stealthModestring · enumOptional

Filter agents by stealth mode status

Possible values:

profileStatusstring · enumOptional

Filter agents by profile status

Possible values:

browserExtensionsstringOptional

Comma-delimited list of BROWSER:INSTALLED pairs to filter by browser extension status. Example: BROWSER_CHROME:true,BROWSER_EDGE:false. Supported browsers: BROWSER_CHROME, BROWSER_EDGE, BROWSER_FIREFOX, BROWSER_SAFARI, BROWSER_ARC, BROWSER_ATLAS, BROWSER_BRAVE, BROWSER_CHROME_BETA, BROWSER_COMET, BROWSER_VIVALDI. INSTALLED is true or false.

Example: BROWSER_CHROME:true,BROWSER_EDGE:false

Responses

200

Successful response

application/json

400

Invalid request parameters

application/json

401

Authentication failure

application/json

429

Rate Limit Exceeded or Daily Quota Exceeded

application/json

500

Internal Nightfall Error

application/json

get

/endpoint/devices

HTTPcURLJavaScriptPython

GET /apps/v1/endpoint/devices HTTP/1.1
Host: api.nightfall.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "agents": [
    {
      "os": "MAC_OS",
      "deviceName": "text",
      "deviceId": "text",
      "macAddresses": [
        "text"
      ],
      "connectionStatus": "ONLINE",
      "lastConnection": "2026-04-03T09:46:21.359Z",
      "agentVersion": "text",
      "osVersion": "text",
      "userEmail": "text",
      "stealthMode": "STEALTH_MODE_STATUS_UNKNOWN",
      "profileStatus": "PROFILE_STATUS_UNKNOWN",
      "missingPermissions": [
        "AGENT_PERMISSION_FULL_DISK_ACCESS"
      ],
      "errors": [
        "AGENT_ERROR_CODE_USER_AGENT_NOT_CONNECTED"
      ],
      "extensionInstallationStatuses": [
        {
          "browser": "BROWSER_CHROME",
          "status": "BROWSER_EXTENSION_INSTALLATION_STATUS_UNKNOWN",
          "extensionConnected": true
        }
      ]
    }
  ],
  "totalAgents": 1,
  "nextPageToken": "text"
}