---
title: "GET /api/v3/accounts/{account_id}/license-maps/"
method: GET
path: "/api/v3/accounts/{account_id}/license-maps/"
tags: ["License Maps"]
---

# GET /api/v3/accounts/{account_id}/license-maps/

`GET /api/v3/accounts/{account_id}/license-maps/`

## Request

- Base URL: `https://cloud.getdbt.com`
- URL: `https://cloud.getdbt.com/api/v3/accounts/{account_id}/license-maps/`
- Auth: HTTP bearer

## Path parameters

- `account_id` integer, required

## Query parameters

- `include_related` string
- `limit` integer
- `offset` integer
- `order_by` string
- `pk` integer
- `state` union
  - integer
  - 'active' | 'deleted' | 'all'

## Response `200`

- LicenseMapListEnveloped
  - `data` LicenseMapResponse[], required
    - `id` integer, required
    - `account_id` integer
    - `license_type` 'developer' | 'read_only' | 'analyst' | 'it': * `developer` - DEVELOPER * `read_only` - READ_ONLY * `analyst` - ANALYST * `it` - IT
    - `state` integer: A value of 1 means this entity is active and a value of 2 means this entity is deleted
    - `sso_license_mapping_groups` string[]
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `extra` Extra, required
    - `filters` object, required: Filters applied to the request
    - `order_by` string, required: Ordering applied to the request
    - `pagination` CustomPagination, required
      - `count` integer, required: Number of items in the current page
      - `total_count` integer, required: Total number of items
  - `status` ResponseStatus, required
    - `code` integer: HTTP status code
    - `is_success` boolean, required: Whether the request was successful or not
    - `user_message` string, required: End-user friendly success or error message
    - `developer_message` string, required: Developer friendly success or error message

## Changes

- **2026-10-06** (v3) `7d5c1b4c8d8a`: 2 breaking
  - for the `path` request parameter `account_id`, the format changed from no format to `int64`
  - for the `query` request parameter `pk`, the format changed from no format to `int64`

[Operation history](https://skmtc.dev/getdbt/apis/dbt-cloud-api-v2/changes/api/v3/accounts/:account_id/license-maps/get.md)

---

[API](https://skmtc.dev/getdbt/apis/dbt-cloud-api-v2.md) - [All operations](https://skmtc.dev/getdbt/apis/dbt-cloud-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/getdbt/apis/dbt-cloud-api-v2/revisions/2448b375ac2f?raw)