## Retrieve Limits

`client.teams.retrieveLimits(stringteamID, RequestOptionsoptions?): TeamRetrieveLimitsResponse`

**get** `/teams/{teamId}/limits`

Retrieve current limits for a team

### Parameters

- `teamID: string`

### Returns

- `TeamRetrieveLimitsResponse`

  - `limits: Limits`

    The actual billing limits values related to the plan

    - `apiKeys: number`

    - `canvasAssetLayers: number`

    - `canvasAssets: number`

    - `collections: number`

    - `creativeUnits: number`

      The amount of Compute Units available for the plan

    - `defaultSeats: number`

    - `downloadAssets: number`

    - `downloadModel: number`

    - `inferenceBatchSize: number`

    - `maxCooldown: number`

      The maximum cooldown applied in case of over head

    - `maxTrainingDatasets: number`

    - `minCooldown: number`

      The minimum cooldown applied in case of over head

    - `models: number`

      The maximum models a project can have (train/upload/copy/transfer/...)

    - `OTPSessions: number`

    - `parallelCustomJobs: number`

    - `parallelInferences: number`

    - `parallelTraining: number`

    - `parallelWorkflowRuns: number`

    - `premiumGenerationSamples: number`

    - `projects: number`

      The maximum projects a team can have

    - `scalingFactor: number`

    - `seats: number`

    - `snapshotsRetention: number`

    - `upload: number`

  - `oneShotCreativeUnits: Array<OneShotCreativeUnit>`

    The list of one-shot Compute Units

    Can be empty if the team has no one-shot Compute Units

    - `amount: number`

      The Compute Units amount bought

    - `createdAt: string`

      The creation date of the Compute Units (buy date)
      ISO string

    - `expiration: string`

      The expiration date of the Compute Units
      ISO string

    - `remaining: number`

      The remaining Compute Units available

    - `updatedAt: string`

      The last update date of the Compute Units (use date)
      ISO string

  - `period: Period`

    The actual billing period start and end dates ISO strings

    - `end: string`

    - `start: string`

  - `plan: "cu-basic" | "cu-creator" | "cu-max" | 9 more`

    The actual plan of the team

    - `"cu-basic"`

    - `"cu-creator"`

    - `"cu-max"`

    - `"cu-pro"`

    - `"cu-pro-q3-25"`

    - `"cu-team"`

    - `"cu-team-v2"`

    - `"enterprise"`

    - `"essential"`

    - `"free"`

    - `"premium"`

    - `"pro"`

  - `values: Values`

    The current value for each relevant limit in the billing period

    - `apiKeys: number`

    - `canvasAssets: number`

    - `collections: number`

    - `creativeUnits: number`

    - `projects: number`

    - `seats: number`

### Example

```typescript
import Scenario from '@scenario-labs/sdk';

const client = new Scenario({
  apiKey: process.env['SCENARIO_SDK_API_KEY'], // This is the default and can be omitted
  apiSecret: process.env['SCENARIO_SDK_API_SECRET'], // This is the default and can be omitted
});

const response = await client.teams.retrieveLimits('teamId');

console.log(response.limits);
```

#### Response

```json
{
  "limits": {
    "apiKeys": 0,
    "canvasAssetLayers": 0,
    "canvasAssets": 0,
    "collections": 0,
    "creativeUnits": 0,
    "defaultSeats": 0,
    "downloadAssets": 0,
    "downloadModel": 0,
    "inferenceBatchSize": 0,
    "maxCooldown": 0,
    "maxTrainingDatasets": 0,
    "minCooldown": 0,
    "models": 0,
    "OTPSessions": 0,
    "parallelCustomJobs": 0,
    "parallelInferences": 0,
    "parallelTraining": 0,
    "parallelWorkflowRuns": 0,
    "premiumGenerationSamples": 0,
    "projects": 0,
    "scalingFactor": 0,
    "seats": 0,
    "snapshotsRetention": 0,
    "upload": 0
  },
  "oneShotCreativeUnits": [
    {
      "amount": 0,
      "createdAt": "createdAt",
      "expiration": "expiration",
      "remaining": 0,
      "updatedAt": "updatedAt"
    }
  ],
  "period": {
    "end": "end",
    "start": "start"
  },
  "plan": "cu-basic",
  "values": {
    "apiKeys": 0,
    "canvasAssets": 0,
    "collections": 0,
    "creativeUnits": 0,
    "projects": 0,
    "seats": 0
  }
}
```