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

# Obtener la campaña de reseñas activa

> GET /campaign/active/

Devuelve la campaña de reseñas de G2 actualmente activa en el host de la **API de gestión** (`api.scanova.io`), autenticado con tu clave sin procesar de la API de gestión — consulta el [resumen](/es/api-reference/management-api/overview) si aún no has configurado esto.

```
GET https://api.scanova.io/campaign/active/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```

Scanova ejecuta campañas periódicas que animan a los clientes satisfechos a dejar una reseña en G2. Este endpoint devuelve el contenido de la campaña — `title`, `button_label`, `link`, y la ventana de fechas en la que está activa — para que una integración pueda mostrar el mismo aviso que muestra el panel de Scanova, si lo desea.

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.scanova.io/campaign/active/" \
    -H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": 4,
    "name": "g2-q3-push",
    "start_date": "2026-07-01",
    "end_date": "2026-09-30",
    "title": "Enjoying Scanova? Leave us a review on G2",
    "button_label": "Write a review",
    "link": "https://www.g2.com/products/scanova/reviews",
    "is_active": true,
    "plans": [12, 14, 27]
  }
  ```
</ResponseExample>

## Sin campaña activa

No siempre hay una campaña en curso. Un `404` aquí significa exactamente eso — no hay nada que mostrar ahora mismo, no es un error. `plans` es la lista de IDs de planes a los que apunta esta campaña; un plan que no esté en esa lista simplemente no verá la campaña en el panel de Scanova, aunque este endpoint en sí no filtra según el plan de la clave que realiza la llamada.

## Relacionado

* [Obtener tu estado de descarte para la campaña activa](/es/api-reference/management-api/campaign/user-log-status) — si esta cuenta ya la ha descartado.
* [Registrar que el popup fue mostrado, descartado o enviado](/es/api-reference/management-api/campaign/user-log-create) — registrar una interacción con ella.
* [Resumen de la API de gestión](/es/api-reference/management-api/overview) — el esquema de autenticación y las reglas de cuota que aplican a este endpoint.


## OpenAPI

````yaml api-reference/openapi/management-api.json GET /campaign/active/
openapi: 3.1.0
info:
  title: Scanova Management API (v2)
  description: >-
    The complete Scanova Management API — every endpoint available at
    api.scanova.io (QR codes, folders, tags, leads, forms, analytics, plans,
    shared users & roles), plus the token-creation and usage-stats endpoints
    used to authenticate against it. Every path and request/response shape below
    was verified live against a real API key and the actual running backend
    (Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
  version: 2.0.0
servers:
  - url: https://api.scanova.io
    description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
  - apiKeyAuth: []
paths:
  /campaign/active/:
    get:
      summary: Get the active review campaign
      description: >-
        Returns the currently active G2 review-prompt campaign, if any — the
        banner text, button label, and link a client would render. Returns 404
        when no campaign is currently active; treat that as "show nothing", not
        an error.
      operationId: getManagedActiveCampaign
      responses:
        '200':
          description: The active campaign.
          content:
            application/json:
              example:
                id: 4
                name: g2-q3-push
                start_date: '2026-07-01'
                end_date: '2026-09-30'
                title: Enjoying Scanova? Leave us a review on G2
                button_label: Write a review
                link: https://www.g2.com/products/scanova/reviews
                is_active: true
                plans:
                  - 12
                  - 14
                  - 27
        '404':
          description: No campaign is currently active.
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Send your Management API key as the raw value of the Authorization
        header — no "Bearer " or "Token " prefix, and no other characters.
        Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
        header containing more than one space-separated part is rejected
        outright. Requests also require the request's Host header to be the
        management API host (e.g. api.scanova.io) — the same key sent to the
        regular API host will not authenticate.

````