Export customer list for billing

Export the list of companies you manage to CSV or Excel for billing, MSSP reporting, license reconciliation, or partner dashboards. Reseller-only — use a credential with Client Role = Reseller. Same endpoint as the export in List companies with license details →; this page focuses on billing and export use cases.

---

POST /api/companies/search/export

Exports the list of companies (with license details) to CSV or Excel. Test it: Authorize with Client ID/Secret, then Send — request body is pre-filled (minimal pagination + exportType: Csv). Use exportType: "Excel" for Excel output.

Exports the list of companies

post

Required scopes

This endpoint requires the following scopes:

• : API

Authorizations

oauth2bearerAuth

OAuth2clientCredentialsRequired

Client ID and Client Secret from Company → Company Settings → REST API. Enter credentials to auto-fetch token.

Token URL:

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

pageNumberintegerRequiredExample: 1

pageSizeintegerRequiredExample: 10

orderBystringRequiredExample: CreateTime

ascendingbooleanRequiredExample: false

isClusteredbooleanOptionalExample: false

isTargetUserCountExceededLimitbooleanOptional

If true, export only companies exceeding license limit

Example: false

reportAllPagesbooleanOptionalExample: false

exportTypestringRequiredExample: CSV

Responses

200

OK

No content

post

/api/companies/search/export

HTTPcURLJavaScriptPython

POST /api/companies/search/export HTTP/1.1
Host: api.keepnetlabs.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 227

{
  "pageNumber": 1,
  "pageSize": 10,
  "orderBy": "CreateTime",
  "ascending": false,
  "isClustered": false,
  "isTargetUserCountExceededLimit": false,
  "reportAllPages": false,
  "exportType": "CSV",
  "filter": {
    "Condition": "AND",
    "SearchInputTextValue": ""
  }
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

200

OK

No content

---

Common errors

• 403 Forbidden — Credential is not Reseller. Set Client Role = Reseller in Company → Company Settings → REST API. Roles and permissions →

• 401 Unauthorized — Missing or invalid token. Request a new token via POST /connect/token.

• 400 Bad Request — Invalid request body. Use minimal body: pageNumber, pageSize, orderBy, ascending, exportType (e.g. Csv).

Related: Paginated list without file download: List companies with license details →. Scope API requests to a customer →.