PlatformBuildAPIChangelog

List Devices

Retrieve a paginated list of devices belonging to an organization.

Workflow Stage: Integrate

Request

GET https://api.controlcomtech.com/v1/organizations/<organizationId>/devices

Replace organizationId with your organization ID. The request must include a valid Authorization header.

Query Parameters

  • Name
    limit
    Type
    integer
    Description

    Maximum number of devices to return per page. Defaults to 25.

  • Name
    cursor
    Type
    string
    Description

    Pagination cursor returned by a previous request, used to fetch the next page.

  • Name
    search
    Type
    string
    Description

    Optional case-insensitive filter applied to the device name.

Response

Returns an object with a data array of device records and a nextCursor for pagination.

  • Name
    data
    Type
    array
    Description

    The list of device objects for the current page.

  • Name
    nextCursor
    Type
    string | null
    Description

    Cursor for the next page, or null when there are no further results.

Example

curl 'https://api.controlcomtech.com/v1/organizations/<organizationId>/devices?limit=25' \
--header 'Authorization: Basic <Base64 Encoded API Key and Secret>'

Was this page helpful?