[GET] Search for all registered software

This endpoint fetches all software registered with the provider, including details about the software, its license type and the linked computers.

Call

GET /v1/softwares

Header

Parameter

Description

Type

Mandatory

Tenant

Name of the provider.

For this information, see the documentation: Portal menus.

string

Yes

Authorization

Authentication token obtained.

string

Yes

Query

Parameter	Description	Type	Mandatory
`$count`	Returns the total number of items matching the query.	`boolean`	No
`$skip`	Skips the first n rows of the results.	`integer`	No
`$top`	Returns only the first n lines of the results.	`integer`	No
`$select`	Selects only the fields specified in the results.	`string`	No
`$orderby`	Sorts the results based on one or more fields.	`string`	No
`$filter`	Filters results based on a condition.	`string`	No
`$pagesize`	Returns the number of records allowed per page. Value applied by default to all calls: `500`. Maximum limit: `500`.	`integer`	No

For more information on filters and pagination, see Search filters and Pagination.

Example request

Search for a list of all the provider's software:

CODE

curl -L -X GET 'https://developer.nddorbix.com/software-external-integration-api/v1/softwares' \
-H 'Tenant: {tenant}' \
-H 'Authorization: Bearer {token}'

Example response

The response code 200 indicates that the search was successful and will return the JSON with the searched data:

CODE

[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "Software",
    "publisher": "Manufacturer",
    "permission": true,
    "category": "Software Development",
    "organization": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "displayName": "Organization"
    },
    "softwares": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "version": "1.0.0",
        "installDate": "2025-02-18T11:14:26.230Z",
        "isLicensed": true,
        "licenseExpirationDate": "2025-02-18T11:14:26.230Z",
        "licenseKey": "123456789",
        "computer": {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "name": "Computer"
        }
      }
    ],
    "license": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "type": 0,
      "isUniqueLicense": true,
      "amount": 0
    }
  }
]