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

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": "CONNECTED",
      "lastConnection": "2025-12-22T22:06:47.015Z",
      "agentVersion": "text",
      "osVersion": "text"
    }
  ],
  "totalAgents": 1,
  "nextPageToken": "text"
}