> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Retrieves the seats on this account
> Obtén la lista de licencias disponibles en la cuenta. Este punto de conexión proporciona detalles sobre cada licencia, como su nombre, descripción y el número de licencias restantes. Es útil para gestionar y revisar las asignaciones de licencias dentro de la organización.
export const ScopesList = ({scopes = [], description = "Esta API requiere uno de los siguientes ámbitos:"}) => {
if (!scopes || scopes.length === 0) {
return null;
}
const sortedScopes = scopes.sort((a, b) => a.localeCompare(b));
return
;
};
## OpenAPI
````yaml specs/2026-09/settings-user-provisioning-v2026-09.json GET /settings/users/2026-09/seats
openapi: 3.0.1
info:
title: Settings User Provisioning
description: Basepom for all HubSpot Projects
version: 2026-09
x-hubspot-product-tier-requirements:
marketing: FREE
sales: FREE
service: FREE
cms: FREE
commerce: FREE
crmHub: FREE
dataHub: FREE
servers:
- url: https://api.hubapi.com
security: []
tags:
- name: Basic
- name: Roles
- name: Seats
- name: Teams
- name: Users
paths:
/settings/users/2026-09/seats:
get:
tags:
- Seats
summary: Recupera las licencias de esta cuenta
description: >-
Obtén la lista de licencias disponibles en la cuenta. Este punto de
conexión proporciona detalles sobre cada licencia, como su nombre,
descripción y el número de licencias restantes. Es útil para gestionar y
revisar las asignaciones de licencias dentro de la organización.
operationId: get-/settings/users/2026-09/seats
parameters: []
responses:
'200':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/CollectionResponsePublicSeatNoPaging'
default:
$ref: '#/components/responses/Error'
description: ''
security:
- oauth2:
- settings.billing.write
components:
schemas:
CollectionResponsePublicSeatNoPaging:
required:
- results
type: object
properties:
results:
type: array
description: >-
Un conjunto de objetos PublicSeat, cada uno de los cuales representa
una licencia con sus propiedades asociadas.
items:
$ref: '#/components/schemas/PublicSeat'
PublicSeat:
required:
- name
type: object
properties:
description:
type: string
description: Una cadena que proporciona detalles adicionales sobre la licencia.
name:
type: string
description: >-
El nombre de la licencia. Esta es una propiedad de cadena
obligatoria.
remainingSeats:
type: integer
description: >-
Un número entero que indica la cantidad de licencias que aún están
disponibles.
format: int32
Error:
required:
- category
- correlationId
- message
type: object
properties:
category:
type: string
description: >-
La categoría del error, que proporciona una clasificación general
del error.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Contexto sobre la condición de error, representado como un objeto
con propiedades adicionales que son secuencias de cadenas.
example: >-
{invalidPropertyName=[propertyValue], missingScopes=[scope1,
scope2]}
correlationId:
type: string
description: >-
Un identificador único para la solicitud. Incluye este valor en
cualquier informe de error o ticket de asistencia. Tiene formato
UUID.
format: uuid
example: aeb5f871-7f07-4993-9211-075dc63e7cbf
errors:
type: array
description: >-
Más información sobre el error, representada como un conjunto de
objetos ErrorDetail.
items:
$ref: '#/components/schemas/ErrorDetail'
links:
type: object
additionalProperties:
type: string
description: >-
Un mapa de nombres de enlaces a URI asociadas que contienen
documentación sobre el error o los pasos recomendados para
solucionarlo.
message:
type: string
description: >-
Un mensaje legible en el que se describa el error y los pasos para
solucionarlo, si procede.
example: An error occurred
subCategory:
type: string
description: >-
Una categoría específica que contiene detalles más concretos acerca
del error.
description: >-
Representa una respuesta de error que devuelve la API cuando una
operación falla. Este componente se usa en varios puntos de terminación
para dar información detallada sobre el error que se encontró.
example:
message: Invalid input (details will vary based on the error)
correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
category: VALIDATION_ERROR
links:
knowledge-base: https://www.hubspot.com/products/service/knowledge-base
ErrorDetail:
required:
- message
type: object
properties:
code:
type: string
description: El código de estado asociado al detalle del error.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Contexto sobre la condición de error, representado como un objeto
con propiedades adicionales. Cada propiedad es un conjunto de
cadenas que proporciona más contexto.
example: '{missingScopes=[scope1, scope2]}'
in:
type: string
description: El nombre del campo o parámetro en el que se encontró el error.
message:
type: string
description: >-
Un mensaje legible que describe el error, junto con los pasos de
solución cuando corresponda. Este es un campo obligatorio.
subCategory:
type: string
description: >-
Una categoría específica que contiene detalles más concretos acerca
del error.
description: >-
Representa información detallada sobre un error que ocurrió en la API.
Este componente se usa para dar contexto adicional y detalles
específicos sobre los errores, normalmente como parte de una respuesta
de error.
responses:
Error:
description: An error occurred.
content:
'*/*':
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://app.hubspot.com/oauth/authorize
tokenUrl: https://api.hubapi.com/oauth/v1/token
scopes:
crm.objects.users.write: ''
settings.billing.write: ''
settings.users.read: ''
settings.users.teams.read: ''
````
{product.name} -
{product.level}
)}