> ## 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 audit logs

> Recupera el historial de actividad de las acciones de los usuarios relacionadas con aprobaciones, actualizaciones de contenido, actualizaciones de objetos del CRM, actividad de seguridad, etc. (solo Enterprise). Más información sobre [actividades incluidas en las exportaciones de registros de auditoría](https://knowledge.hubspot.com/account-management/view-and-export-account-activity-history-in-a-centralized-audit-log?hubs_content=knowledge.hubspot.com/account-management/view-and-export-account-activity-history&hubs_content-cta=centralized%20audit%20log#data-included-in-the-centralized-audit-log).

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={[
  'account-info.security.read'
]}
    />
  </Accordion>
</AccordionGroup>


## OpenAPI

````yaml specs/2026-03/account-audit-logs-v2026-03.json GET /account-info/2026-03/activity/audit-logs
openapi: 3.0.1
info:
  title: Registros de auditoría
  description: Basepom for all HubSpot Projects
  version: 2026-03
  x-hubspot-product-tier-requirements:
    marketing: FREE
    sales: FREE
    service: FREE
    cms: FREE
    commerce: FREE
    crmHub: FREE
    dataHub: FREE
  x-hubspot-api-use-case: >-
    Quieres crear una herramienta interna para que tu equipo de cumplimiento
    normativo supervise con regularidad la actividad de los empleados de tu
    empresa que acceden a los datos de tu cuenta de HubSpot.
  x-hubspot-introduction: >-
    La API de actividad de la cuenta permite obtener el historial de inicios de
    sesión y la actividad de seguridad de tu cuenta de HubSpot.
servers:
  - url: https://api.hubapi.com
security: []
tags:
  - name: Basic
paths:
  /account-info/2026-03/activity/audit-logs:
    get:
      tags:
        - Basic
      summary: Recuperar registros de auditoría
      description: >-
        Recupera el historial de actividad de las acciones de los usuarios
        relacionadas con aprobaciones, actualizaciones de contenido,
        actualizaciones de objetos del CRM, actividad de seguridad, etc. (solo
        Enterprise). Más información sobre [actividades incluidas en las
        exportaciones de registros de
        auditoría](https://knowledge.hubspot.com/account-management/view-and-export-account-activity-history-in-a-centralized-audit-log?hubs_content=knowledge.hubspot.com/account-management/view-and-export-account-activity-history&hubs_content-cta=centralized%20audit%20log#data-included-in-the-centralized-audit-log).
      operationId: get-/account-info/2026-03/activity/audit-logs
      parameters:
        - name: actingUserId
          in: query
          description: ''
          required: false
          style: form
          explode: true
          schema:
            type: array
            items:
              type: integer
              format: int32
        - name: after
          in: query
          description: >-
            El token del cursor de paginación del último recurso leído con éxito
            se devolverá como la propiedad JSON `paging.next.after` de una
            respuesta paginada que contenga más resultados.
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: fillFinalTimestamp
          in: query
          description: ''
          required: false
          style: form
          explode: true
          schema:
            type: boolean
        - name: limit
          in: query
          description: El número máximo de resultados que se mostrarán por página.
          required: false
          style: form
          explode: true
          schema:
            type: integer
            format: int32
        - name: occurredAfter
          in: query
          description: ''
          required: false
          style: form
          explode: true
          schema:
            type: string
            format: date-time
        - name: occurredBefore
          in: query
          description: ''
          required: false
          style: form
          explode: true
          schema:
            type: string
            format: date-time
        - name: sort
          in: query
          description: ''
          required: false
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/CollectionResponsePublicApiUserActionEventForwardPaging
        default:
          $ref: '#/components/responses/Error'
          description: ''
      security:
        - oauth2:
            - account-info.security.read
components:
  schemas:
    CollectionResponsePublicApiUserActionEventForwardPaging:
      required:
        - results
      type: object
      properties:
        paging:
          $ref: '#/components/schemas/ForwardPaging'
        results:
          type: array
          items:
            $ref: '#/components/schemas/PublicApiUserActionEvent'
    ForwardPaging:
      type: object
      properties:
        next:
          $ref: '#/components/schemas/NextPage'
    PublicApiUserActionEvent:
      required:
        - actingUser
        - action
        - category
        - id
        - occurredAt
      type: object
      properties:
        actingUser:
          $ref: '#/components/schemas/ActingUser'
        action:
          type: string
          description: El tipo de acción tomada.
        category:
          type: string
          description: La categoría de la actividad.
        id:
          type: string
          description: El ID único de la actividad de inicio de sesión.
        occurredAt:
          type: string
          description: La hora en la que se produjo la acción.
          format: date-time
        subCategory:
          type: string
          description: La subcategoría de la actividad.
        targetObjectId:
          type: string
          description: El ID del objeto impactado.
    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
    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
    ActingUser:
      required:
        - userId
      type: object
      properties:
        userEmail:
          type: string
          description: >-
            La dirección de correo electrónico del usuario que realizó la
            acción.
        userId:
          type: integer
          description: El ID único del usuario.
          format: int32
    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
  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:
            account-info.security.read: ''
            oauth: ''

````