> ## Documentation Index
> Fetch the complete documentation index at: https://br.developers.hubspot.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve a campaign

> Obtenha uma campanha identificada por um campaignGuid específico com as propriedades fornecidas. Junto com as informações da campanha, também retorna informações sobre os ativos. Dependendo dos parâmetros de consulta usados, também pode ser utilizado para retornar informações sobre as métricas dos ativos correspondentes. As métricas estão disponíveis somente se startDate e endDate forem especificadas.

> **Supported products**

> **Required Scopes**


## OpenAPI

````yaml specs/2026-03/marketing-campaigns-public-api-v2026-03.json GET /marketing/campaigns/2026-03/{campaignGuid}
openapi: 3.0.1
info:
  title: Marketing Campaigns Public Api
  description: Basepom for all HubSpot Projects
  version: 2026-03
  x-hubspot-product-tier-requirements:
    marketing: PROFESSIONAL
    sales: FREE
    service: FREE
    cms: FREE
    commerce: FREE
    crmHub: FREE
    dataHub: FREE
servers:
  - url: https://api.hubapi.com
security: []
tags:
  - name: Assets
  - name: Basic
  - name: Batch
  - name: Budget
  - name: Metrics
  - name: Spend
paths:
  /marketing/campaigns/2026-03/{campaignGuid}:
    get:
      tags:
        - Basic
      summary: Ler uma campanha
      description: >-
        Obtenha uma campanha identificada por um campaignGuid específico com as
        propriedades fornecidas. Junto com as informações da campanha, também
        retorna informações sobre os ativos. Dependendo dos parâmetros de
        consulta usados, também pode ser utilizado para retornar informações
        sobre as métricas dos ativos correspondentes. As métricas estão
        disponíveis somente se startDate e endDate forem especificadas.
      operationId: get-/marketing/campaigns/2026-03/{campaignGuid}
      parameters:
        - name: campaignGuid
          in: path
          description: |-
            O UUID da campanha; obrigatório
            Exemplo: 9dbec438-53e2-4b28-8c0f-38f56574a6e8
          required: true
          style: simple
          explode: false
          schema:
            type: string
        - name: endDate
          in: query
          description: |-
            A data final para buscar métricas de ativos, no formato AAAA-MM-DD.
            Opcional. Exemplo: 2000-01-27
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: properties
          in: query
          description: >-
            Uma lista de propriedades separadas por vírgulas para incluir na
            resposta.  
              Propriedades não reconhecidas são ignoradas. Opcional. Exemplo: hs_name, hs_budget, hs_notes
          required: false
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
        - name: startDate
          in: query
          description: >-
            A data de início para buscar métricas de ativos, no formato
            AAAA-MM-DD. 

            Opcional. Exemplo: 2000-01-20         
          required: false
          style: form
          explode: true
          schema:
            type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicCampaignWithAssets'
        default:
          $ref: '#/components/responses/Error'
          description: ''
      security:
        - oauth2:
            - marketing.campaigns.read
components:
  schemas:
    PublicCampaignWithAssets:
      required:
        - assets
        - businessUnits
        - createdAt
        - id
        - properties
        - updatedAt
      type: object
      properties:
        assets:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/CollectionResponsePublicCampaignAsset'
          description: >-
            Contém os recursos associados à campanha, cada um representado como
            um conjunto de ativos da campanha.
        businessUnits:
          type: array
          description: >-
            Uma matriz de unidades de negócios associadas à campanha, cada uma
            representada por um objeto PublicBusinessUnit.
          items:
            $ref: '#/components/schemas/PublicBusinessUnit'
        createdAt:
          type: string
          description: >-
            A data e a hora de criação da campanha, formatadas como uma string
            de data e hora.
          format: date-time
        id:
          type: string
          description: O identificador exclusivo da campanha.
        properties:
          type: object
          additionalProperties:
            type: string
          description: >-
            Um mapa de pares chave-valor representando as propriedades da
            campanha.
        updatedAt:
          type: string
          description: >-
            A data e a hora da última atualização da campanha, formatadas como
            uma string de data e hora.
          format: date-time
    CollectionResponsePublicCampaignAsset:
      required:
        - results
      type: object
      properties:
        paging:
          $ref: '#/components/schemas/Paging'
        results:
          type: array
          description: >-
            Uma matriz de ativos de campanha públicos. Cada item na matriz é um
            objeto que representa um ativo de campanha.
          items:
            $ref: '#/components/schemas/PublicCampaignAsset'
    PublicBusinessUnit:
      required:
        - id
      type: object
      properties:
        id:
          type: integer
          description: >-
            O identificador exclusivo da unidade de negócios, representado por
            um número inteiro.
          format: int64
    Error:
      required:
        - category
        - correlationId
        - message
      type: object
      properties:
        category:
          type: string
          description: A categoria de erro
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: Contexto sobre a condição do erro
          example: >-
            {invalidPropertyName=[propertyValue], missingScopes=[scope1,
            scope2]}
        correlationId:
          type: string
          description: >-
            Um identificador exclusivo para a solicitação. Inclua este valor em
            relatórios de erro ou tickets de suporte
          format: uuid
          example: aeb5f871-7f07-4993-9211-075dc63e7cbf
        errors:
          type: array
          description: mais informações sobre o erro
          items:
            $ref: '#/components/schemas/ErrorDetail'
        links:
          type: object
          additionalProperties:
            type: string
          description: >-
            Um mapa de nomes de links para URIs associados que contêm
            documentação sobre o erro ou as etapas de correção recomendadas
        message:
          type: string
          description: >-
            Uma mensagem legível por humanos que descreve o erro, juntamente com
            as etapas de correção, quando apropriado
          example: An error occurred
        subCategory:
          type: string
          description: >-
            Uma categoria específica que contém mais detalhes específicos sobre
            o erro
      description: >-
        Representa uma resposta de erro retornada pela API quando uma operação
        falha. Este componente é usado em vários endpoints para fornecer
        informações detalhadas sobre o erro encontrado.
      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'
      description: >-
        Representa as informações de paginação para navegar por uma lista de
        resultados na API. Ele fornece detalhes sobre como acessar o conjunto
        anterior ou seguinte de resultados.
    PublicCampaignAsset:
      required:
        - id
      type: object
      properties:
        id:
          type: string
          description: O identificador exclusivo do ativo de campanha.
        metrics:
          type: object
          additionalProperties:
            type: number
          description: >-
            Um conjunto de métricas associadas ao ativo da campanha,
            representadas como pares chave-valor.
        name:
          type: string
          description: O nome do ativo de campanha.
    ErrorDetail:
      required:
        - message
      type: object
      properties:
        code:
          type: string
          description: O código de status associado ao detalhe do erro
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: Contexto sobre a condição do erro
          example: '{missingScopes=[scope1, scope2]}'
        in:
          type: string
          description: O nome do campo ou parâmetro no qual o erro foi encontrado.
        message:
          type: string
          description: >-
            Uma mensagem legível por humanos que descreve o erro, juntamente com
            as etapas de correção, quando apropriado
        subCategory:
          type: string
          description: >-
            Uma categoria específica que contém mais detalhes específicos sobre
            o erro
      description: >-
        Representa informações detalhadas sobre um erro ocorrido na API. Este
        componente é usado para fornecer contexto e detalhes adicionais sobre os
        erros, geralmente como parte de uma resposta de erro.
    NextPage:
      required:
        - after
      type: object
      properties:
        after:
          type: string
          description: >-
            Um token de string usado como cursor para recuperar a próxima página
            de resultados.
        link:
          type: string
          description: >-
            Um URL de string que fornece o link para a próxima página de
            resultados.
      description: >-
        Specifies the paging information needed to retrieve the next set of
        results in a paginated API response
    PreviousPage:
      required:
        - before
      type: object
      properties:
        before:
          type: string
          description: >-
            Um token de string que indica a posição na lista antes da página de
            resultados atual.
        link:
          type: string
          description: >-
            Uma string que contém o link do URL para a página anterior de
            resultados.
      description: >-
        specifies the paging information needed to retrieve the previous set of
        results in a paginated API response
  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:
            marketing.campaigns.read: ''
            marketing.campaigns.revenue.full.read: ''
            marketing.campaigns.revenue.lite.read: ''
            marketing.campaigns.revenue.read: ''
            marketing.campaigns.write: ''

````