> ## 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.

# Read

> Lee un objeto identificado por `{dealId}`. `{dealId}` se refiere al ID de objeto interno por opción predeterminada o, de manera opcional, a cualquier valor de propiedad único especificado por el parámetro de consulta `idProperty`. Controla lo que se devuelve mediante el parámetro de consulta `properties`.

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 <div>
      <div className="text-sm mb-2">{description}</div>
      <div>
        {sortedScopes.map((scope, index) => <div key={index}>
            <code>
              <span className="text-xs">{scope}</span>
            </code>
          </div>)}
      </div>
    </div>;
};

export const SupportedProducts = ({marketing, sales, service, cms, marketingLevel, salesLevel, serviceLevel, cmsLevel}) => {
  const translations = {
    header: "Productos compatibles",
    description: "Se requiere uno de los siguientes productos o productos de ediciones superiores.",
    productNames: {
      marketing: "Marketing Hub",
      sales: "Sales Hub",
      service: "Service Hub",
      cms: "Content Hub"
    },
    tiers: {
      free: "Gratuito",
      starter: "Starter",
      professional: "Pro",
      enterprise: "Enterprise"
    }
  };
  const translateTier = tier => {
    if (!tier) return '';
    const lowerTier = tier.toLowerCase();
    return translations.tiers[lowerTier] || tier;
  };
  const products = [{
    name: marketing ? translations.productNames.marketing : '',
    level: translateTier(marketingLevel),
    icon: "https://mintlify-assets.b-cdn.net/Icons/marketing-bolt.svg",
    alt: "Marketing Hub"
  }, {
    name: sales ? translations.productNames.sales : '',
    level: translateTier(salesLevel),
    icon: "https://mintlify-assets.b-cdn.net/Icons/sales-star.svg",
    alt: "Sales Hub"
  }, {
    name: service ? translations.productNames.service : '',
    level: translateTier(serviceLevel),
    icon: "https://mintlify-assets.b-cdn.net/Icons/service-heart.svg",
    alt: "Service Hub"
  }, {
    name: cms ? translations.productNames.cms : '',
    level: translateTier(cmsLevel),
    icon: "https://mintlify-assets.b-cdn.net/Icons/content-play.svg",
    alt: "Content Hub"
  }].filter(product => product.name && product.level);
  if (products.length === 0) return null;
  return <div>
      <div className="text-sm mb-2">{translations.description}</div>
      <div className={`grid ${products.length === 1 ? 'grid-cols-1' : 'grid-cols-2'} gap-1.5`}>
        {products.map((product, index) => <div key={index} style={{
    display: 'flex',
    alignItems: 'center'
  }}>
            <img src={product.icon} alt={product.alt} className="w-3.5 h-3.5 mr-1.5 mt-2.5 mb-2.5 flex-shrink-0 align-middle" />
            <span className="font-medium mr-1 text-sm">{product.name} -</span>
            <span className="text-sm">{product.level}</span>
          </div>)}
      </div>
    </div>;
};

<AccordionGroup>
  <Accordion title="Supported products" defaultOpen="true" icon="cubes">
    <SupportedProducts marketing={true} sales={true} service={true} cms={true} marketingLevel="FREE" salesLevel="FREE" serviceLevel="FREE" cmsLevel="FREE" />
  </Accordion>

  <Accordion title="Required Scopes" icon="key">
    <ScopesList
      scopes={[
  'crm.objects.deals.read'
]}
    />
  </Accordion>
</AccordionGroup>


## OpenAPI

````yaml specs/legacy/v3/crm-deals-v3.json GET /crm/v3/objects/0-3/{dealId}
openapi: 3.0.1
info:
  title: Negocios
  description: >-
    CRM objects such as companies, contacts, deals, line items, products,
    tickets, and quotes are standard objects in HubSpot’s CRM. These core
    building blocks support custom properties, store critical information, and
    play a central role in the HubSpot application.


    ## Supported Object Types


    This API provides access to collections of CRM objects, which return a map
    of property names to values. Each object type has its own set of default
    properties, which can be found by exploring the [CRM Object Properties
    API](https://developers.hubspot.com/docs/methods/crm-properties/crm-properties-overview).


    |Object Type |Properties returned by default |

    |--|--|

    | `companies` | `name`, `domain` |

    | `contacts` | `firstname`, `lastname`, `email` |

    | `deals` | `dealname`, `amount`, `closedate`, `pipeline`, `dealstage` |

    | `products` | `name`, `description`, `price` |

    | `tickets` | `content`, `hs_pipeline`, `hs_pipeline_stage`,
    `hs_ticket_category`, `hs_ticket_priority`, `subject` |


    Find a list of all properties for an object type using the [CRM Object
    Properties](https://developers.hubspot.com/docs/methods/crm-properties/get-properties)
    API. e.g. `GET https://api.hubapi.com/properties/v2/companies/properties`.
    Change the properties returned in the response using the `properties` array
    in the request body.
  version: v3
  x-hubspot-product-tier-requirements:
    marketing: FREE
    sales: FREE
    service: FREE
    cms: FREE
    commerce: FREE
    crmHub: FREE
    dataHub: FREE
  x-hubspot-api-use-case: >-
    Cuando un representante de ventas comienza a trabajar con un prospecto, crea
    un registro de negocios para hacer seguimiento del proceso de negociación.
    Cuando el cliente más adelante realice su compra, podrás actualizar el
    negocio a una etapa de cierre.
  x-hubspot-related-documentation:
    - name: Deals Guide
      url: https://developers.hubspot.com/docs/guides/api/crm/objects/deals
  x-hubspot-introduction: >-
    Utiliza la API de negocios para crear y gestionar registros del CRM que
    representen transacciones con contactos o empresas. Los negocios avanzan a
    través de las etapas del pipeline para reflejar si la transacción se hizo,
    está activa o se perdió.
servers:
  - url: https://api.hubapi.com
security: []
tags:
  - name: Basic
  - name: Batch
  - name: Search
paths:
  /crm/v3/objects/0-3/{dealId}:
    get:
      tags:
        - Basic
      summary: Leer
      description: >-
        Lee un objeto identificado por `{dealId}`. `{dealId}` se refiere al ID
        de objeto interno por opción predeterminada o, de manera opcional, a
        cualquier valor de propiedad único especificado por el parámetro de
        consulta `idProperty`. Controla lo que se devuelve mediante el parámetro
        de consulta `properties`.
      operationId: get-/crm/v3/objects/0-3/{dealId}_getById
      parameters:
        - name: dealId
          in: path
          required: true
          schema:
            pattern: .+
            type: string
        - name: archived
          in: query
          description: Si se devolverán solo los resultados que se han archivado.
          required: false
          style: form
          explode: true
          schema:
            type: boolean
            default: false
        - name: associations
          in: query
          description: >-
            Una lista separada por comas de los tipos de objetos para los que se
            recuperarán los ID asociados. Si alguna de las asociaciones
            especificadas no existe, se ignorará.
          required: false
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
        - name: idProperty
          in: query
          description: >-
            El nombre de una propiedad cuyos valores son únicos para este tipo
            de objeto
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: properties
          in: query
          description: >-
            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á.
          required: false
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
        - name: propertiesWithHistory
          in: query
          description: >-
            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á.
          required: false
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SimplePublicObjectWithAssociations'
        default:
          $ref: '#/components/responses/Error'
          description: ''
      security:
        - oauth2:
            - crm.objects.deals.read
components:
  schemas:
    SimplePublicObjectWithAssociations:
      required:
        - archived
        - createdAt
        - id
        - properties
        - updatedAt
      type: object
      properties:
        archived:
          type: boolean
          description: Si se archiva o no el objeto.
        archivedAt:
          type: string
          description: >-
            La marca de tiempo en la que se archivó el objeto, en formato ISO
            8601.
          format: date-time
        associations:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/CollectionResponseAssociatedId'
          description: Una lista de relaciones de definición con otros objetos.
        createdAt:
          type: string
          description: La marca de tiempo en la que se creó el objeto, en formato ISO 8601.
          format: date-time
        id:
          type: string
          description: El ID único del objeto
        objectWriteTraceId:
          type: string
          description: >-
            Un identificador utilizado para rastrear la solicitud de creación o
            actualización del objeto.
        properties:
          type: object
          additionalProperties:
            type: string
          description: Pares clave-valor que representan las propiedades del objeto.
        propertiesWithHistory:
          type: object
          additionalProperties:
            type: array
            items:
              $ref: '#/components/schemas/ValueWithTimestamp'
          description: >-
            Pares clave-valor que representan las propiedades del objeto junto
            con su historial.
        updatedAt:
          type: string
          description: >-
            La marca de tiempo de la última vez que se actualizó el objeto, en
            formato ISO 8601.
          format: date-time
        url:
          type: string
          description: >-
            La URL de la API que permite la navegación directa a las páginas de
            interfaz de usuario correspondientes a los conectores.
        warnings:
          type: array
          items:
            $ref: '#/components/schemas/PublicObjectWarning'
      description: >-
        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.
    CollectionResponseAssociatedId:
      required:
        - results
      type: object
      properties:
        paging:
          $ref: '#/components/schemas/Paging'
        results:
          type: array
          items:
            $ref: '#/components/schemas/AssociatedId'
    ValueWithTimestamp:
      required:
        - sourceType
        - timestamp
        - value
      type: object
      properties:
        sourceId:
          type: string
          description: El ID único de la propiedad.
        sourceLabel:
          type: string
          description: Una etiqueta legible para humanos.
        sourceType:
          type: string
          description: El tipo de propiedad.
        timestamp:
          type: string
          description: >-
            La marca de tiempo en la que se actualizó la propiedad, en formato
            ISO 8601.
          format: date-time
        updatedByUserId:
          type: integer
          description: El ID del usuario que actualizó la propiedad por última vez.
          format: int32
        value:
          type: string
          description: El valor de propiedad
      description: Modelo de propiedad que incluye marca de tiempo.
    PublicObjectWarning:
      required:
        - category
        - context
        - message
      type: object
      properties:
        category:
          type: string
        context:
          type: object
          additionalProperties:
            type: string
        message:
          type: string
    Error:
      required:
        - category
        - correlationId
        - message
      type: object
      properties:
        category:
          type: string
          description: La categoría del error
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: Contexto de la condición de error
          example: >-
            {invalidPropertyName=[propertyValue], missingScopes=[scope1,
            scope2]}
        correlationId:
          type: string
          description: >-
            Un identificador único para la solicitud. Incluye este valor con
            cualquier informe de error o ticket de asistencia.
          format: uuid
          example: aeb5f871-7f07-4993-9211-075dc63e7cbf
        errors:
          type: array
          description: información adicional acerca del error
          items:
            $ref: '#/components/schemas/ErrorDetail'
        links:
          type: object
          additionalProperties:
            type: string
          description: >-
            Un mapa de nombres de enlaces a las 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
      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
    Paging:
      type: object
      properties:
        next:
          $ref: '#/components/schemas/NextPage'
        prev:
          $ref: '#/components/schemas/PreviousPage'
    AssociatedId:
      required:
        - id
        - type
      type: object
      properties:
        id:
          type: string
          description: El ID del tipo de asociación.
        type:
          type: string
          description: El tipo de asociación.
          example: deal_to_contact
      description: Contiene el ID y el tipo de una asociación
    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 de la condición de error
          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 en el que se describa el error y los pasos para
            solucionarlo, si procede
        subCategory:
          type: string
          description: >-
            Una categoría específica que contiene detalles más concretos acerca
            del error
    NextPage:
      required:
        - after
      type: object
      properties:
        after:
          type: string
          description: >-
            Un token del cursor de paginación para recuperar páginas
            posteriores.
        link:
          type: string
          description: >-
            Una URL que se puede utilizar para recuperar los resultados de la
            página siguiente.
      description: >-
        Especifica la información de paginación necesaria para obtener el
        siguiente conjunto de resultados en una respuesta paginada de la API
      example:
        after: NTI1Cg%3D%3D
        link: '?after=NTI1Cg%3D%3D'
    PreviousPage:
      required:
        - before
      type: object
      properties:
        before:
          type: string
          description: Un token del cursor de paginación para recuperar páginas anteriores.
        link:
          type: string
          description: >-
            Una URL que se puede utilizar para recuperar los resultados de las
            páginas anteriores.
      description: >-
        especifica la información de paginación necesaria para obtener el
        conjunto anterior de resultados en una respuesta paginada de la API
  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.commercepayments.read: ''
            crm.objects.deals.read: ''
            crm.objects.deals.write: ''
            oauth: ''

````