Skip to main content
GET
Leer

Supported products

Autorizaciones

Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

FlowAuthorization Code
Authorization URL
https://app.hubspot.com/oauth/authorize
Token URL
https://api.hubapi.com/oauth/v1/token
Scopes1
crm.objects.deals.read

Parámetros de ruta

objectId
string
requerido

El identificador único del objeto que se obtendrá.

objectType
string
requerido

El tipo de objeto que se recuperará.

Parámetros de consulta

archived
boolean
predeterminado:false

Si se devuelven solo los resultados que se han archivado. La opción predeterminada es falso.

associations
string[]

Una lista de tipos de objetos separados por comas para recuperar los ID asociados. Si alguna de las asociaciones especificadas no existe, se ignorará.

idProperty
string

El nombre de una propiedad cuyos valores son únicos para este tipo de objeto.

properties
string[]

Una lista separada por comas de las propiedades que se devolverán en la respuesta. Si alguna de las propiedades especificadas no está presente en los objetos solicitados, se ignorará.

propertiesWithHistory
string[]

Una lista separada por comas de las propiedades que se devolverán junto con su historial de valores anteriores. Si alguna de las propiedades especificadas no está presente en los objetos solicitados, se ignorará.

Respuesta

successful operation

Representa un objeto de CRM junto con sus propiedades, marcas de tiempo y un conjunto de ID de objetos asociados agrupados por tipo de asociación.

archived
boolean
requerido

Un booleano que indica si este objeto está archivado.

createdAt
string<date-time>
requerido

La fecha y hora en que se creó este objeto, en formato ISO 8601.

id
string
requerido

El identificador único para este objeto del CRM.

properties
object
requerido

Un mapa de los nombres de las propiedades y sus valores actuales para este objeto.

updatedAt
string<date-time>
requerido

La fecha y hora de la última actualización de este objeto, en formato ISO 8601.

archivedAt
string<date-time>

La fecha y hora en que se archivó este objeto, en formato ISO 8601.

associations
object

Un mapa de tipos de objetos asociados con sus respectivos ID asociados.

objectWriteTraceId
string

Un identificador que se usa para rastrear las operaciones de escritura de este objeto.

propertiesWithHistory
object

Un mapa de los nombres de las propiedades y sus valores, junto con un historial de cambios, incluidas las marcas de tiempo.

url
string

El enlace URL para acceder a este objeto.

warnings
object[]

Una lista de advertencias asociadas con este objeto, cada una con una categoría, mensaje y contexto.

Última modificación el 23 de septiembre de 2026