---
title: "Get a list of licenses updates"
method: GET
path: "/license_updates"
tags: ["Licenses"]
---

# Get a list of licenses updates

`GET /license_updates`

## Request

- Base URL: `https://api.togai.com`
- URL: `https://api.togai.com/license_updates`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/togaihq/apis/togai-apis/docs/license_updates/get.ts> (a function with typed inputs; its response is checked against the schema)

This API let’s you to fetch a list of licenses updates with multiple query parameters

## Query parameters

- `nextToken` string
- `account_id` string
- `pageSize` integer
- `licenseId` string
- `effectiveFrom` string, date-time

## Response `200`

Success response

- GetLicenseUpdatesResponse: Get license updates response
  - `data` LicenseUpdateResponse[], required
    - `licenseId` string, required
    - `accountId` string, required
    - `quantity` number, required: Absolute quantity of the license
    - `effectiveFrom` string, date-time, required
    - `metadata` object
    - `createdAt` string, date-time, required
  - `nextToken` string

## Other responses

- `400`: Bad request. Please check the response message for failure details.
- `401`: Credential is not valid. Please check the response message for failure details.
- `403`: Credential does not have access to list licenses updates.
- `422`: Unable to process the query parameters provided. Please check our docs for the api limits - https://togai.io/docs/limits.
- `429`: Request throttled. Please check the response message on the failure details.
- `default`: Error response

## Changes

- **2024-07-11** `5abfbfe439be`: 1 breaking
  - the `data/items/allOf[#/components/schemas/LicenseUpdate]/quantity` response's property type changed from `integer` to `number` for status `200`
- **2024-01-05** `ea9c4628bfdb`: 1 info
  - added the optional property `data/items/allOf[#/components/schemas/LicenseUpdate]/metadata` to the response with the `200` status
- **2023-10-16** `898bb5f2ce0c`: 5 info
  - added the new optional `query` request parameter `account_id`
  - added the new optional `query` request parameter `effectiveFrom`
  - added the new optional `query` request parameter `licenseId`
  - added the new optional `query` request parameter `nextToken`
  - …1 more
- **2023-09-02** `6b13f6f47735`: 6 warning
  - deleted the `query` request parameter `account_id`
  - deleted the `query` request parameter `effectiveFrom`
  - deleted the `query` request parameter `licenseId`
  - deleted the `query` request parameter `nextToken`
  - …2 more

[Operation history](https://skmtc.dev/togaihq/apis/togai-apis/changes/license_updates/get.md)

---

[API](https://skmtc.dev/togaihq/apis/togai-apis.md) - [All operations](https://skmtc.dev/togaihq/apis/togai-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/togaihq/apis/togai-apis/revisions/442f5d8f4aa0?raw)