> ## 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.
# Retrieve Approval
> Obtén el estado de aprobación de un objeto específico dentro de un pipeline. Este punto de conexión es útil para verificar el estado de aprobación actual de un objeto, lo cual puede ser fundamental en workflows que requieren pasos de validación o autorizació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/crm-pipeline-governance-v2026-09.json GET /crm/pipelines-rules/2026-09/{objectTypeId}/{pipelineId}/approvals/{objectId}
openapi: 3.0.1
info:
title: CRM Pipeline Governance
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: Advanced
- name: Basic
paths:
/crm/pipelines-rules/2026-09/{objectTypeId}/{pipelineId}/approvals/{objectId}:
get:
tags:
- Basic
summary: Recuperar aprobación
description: >-
Obtén el estado de aprobación de un objeto específico dentro de un
pipeline. Este punto de conexión es útil para verificar el estado de
aprobación actual de un objeto, lo cual puede ser fundamental en
workflows que requieren pasos de validación o autorización.
operationId: >-
get-/crm/pipelines-rules/2026-09/{objectTypeId}/{pipelineId}/approvals/{objectId}
parameters:
- name: objectId
in: path
description: >-
El identificador único del objeto para el que se está recuperando el
estado de aprobación.
required: true
style: simple
explode: false
schema:
type: integer
format: int64
- name: objectTypeId
in: path
description: >-
El identificador único para el tipo de objeto al que se hace
referencia.
required: true
style: simple
explode: false
schema:
type: string
- name: pipelineId
in: path
description: El identificador único del pipeline que contiene el objeto.
required: true
style: simple
explode: false
schema:
type: string
responses:
'200':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/PublicObjectApprovalStatus'
default:
$ref: '#/components/responses/Error'
description: ''
security:
- oauth2:
- deal-approval-read
components:
schemas:
PublicObjectApprovalStatus:
required:
- approvalStatus
- createdAt
- id
- objectId
- objectTypeId
- pipelineId
- pipelineStageId
- updatedAt
type: object
properties:
approvalId:
type: string
description: >-
El identificador único de la instancia del proceso de aprobación
asociada a este objeto.
approvalStatus:
type: string
description: >-
El estado de aprobación actual del objeto. Esto indica si el objeto
está aprobado, pendiente de aprobación o rechazado.
enum:
- APPROVED
- NO_APPROVAL_NEEDED
- NOT_APPLICABLE
- PENDING
- REJECTED
createdAt:
type: string
description: >-
La fecha y hora en que se creó este registro de estado de
aprobación, en formato ISO 8601.
format: date-time
id:
type: string
description: El identificador único para este objeto de estado de aprobación.
objectId:
type: string
description: >-
El identificador único del objeto cuyo estado de aprobación se está
monitorizando.
objectTypeId:
type: string
description: >-
El identificador de tipo del objeto, que indica qué tipo de objeto
se está aprobando.
pipelineId:
type: string
description: >-
El identificador único del pipeline en el que se encuentra el
objeto.
pipelineStageId:
type: string
description: >-
El identificador único de la etapa del pipeline en la que está el
objeto actualmente.
updatedAt:
type: string
description: >-
La fecha y hora en que este registro de estado de aprobación se
actualizó por última vez, en formato ISO 8601.
format: date-time
Error:
required:
- category
- correlationId
- message
type: object
properties:
category:
type: string
description: Una cadena que representa la categoría general del error.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Un objeto que contiene contexto adicional sobre la condición del
error, con propiedades como conjuntos de cadenas.
example: >-
{invalidPropertyName=[propertyValue], missingScopes=[scope1,
scope2]}
correlationId:
type: string
description: >-
Una cadena que identifica de forma única la solicitud para fines de
seguimiento y depuración.
format: uuid
example: aeb5f871-7f07-4993-9211-075dc63e7cbf
errors:
type: array
description: >-
Un conjunto de objetos ErrorDetail que proporcionan información
detallada sobre cada error encontrado.
items:
$ref: '#/components/schemas/ErrorDetail'
links:
type: object
additionalProperties:
type: string
description: >-
Un objeto que contiene enlaces relacionados, donde cada clave es una
cadena y el valor es una cadena que representa una URL.
message:
type: string
description: >-
Una cadena que contiene un mensaje comprensible para los humanos que
describe el error.
example: An error occurred
subCategory:
type: string
description: >-
Una cadena que proporciona detalles más específicos sobre la
categoría 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 con el detalle del error. Esta es una
propiedad de cadena.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Contexto sobre la condición del error, representado como un objeto
con propiedades adicionales. Cada propiedad es un conjunto de
cadenas que proporciona más detalles.
example: '{missingScopes=[scope1, scope2]}'
in:
type: string
description: >-
El nombre del campo o parámetro en el que se encontró el error. Esta
es una propiedad de cadena.
message:
type: string
description: >-
Un mensaje legible que describe el error, junto con los pasos de
solución cuando corresponda. Es una propiedad de cadena obligatoria.
subCategory:
type: string
description: >-
Una categoría específica que contiene detalles más concretos sobre
el error. Esta es una propiedad de cadena.
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-access: ''
crm-pipelines-governance-read: ''
crm-pipelines-governance-write: ''
crm-pipelines-locked-stages-access: ''
crm-pipelines-locked-stages-write: ''
deal-approval-read: ''
pipeline-level-permissions-access: ''
pipeline-level-permissions-write: ''
````
{product.name} -
{product.level}
)}