---
title: "Obtener Campañas"
method: GET
path: "/v1/campaigns"
tags: ["Campaigns"]
---

# Obtener Campañas

`GET /v1/campaigns`

Consulta la información de todas las campañas que se han enviado de manera masiva.

## Query parameters

- `page` integer
- `limit` integer
- `botId` string, required
- `startAt` string, date, required
- `endAt` string, date, required
- `elementName` string
- `status` 'COMPLETED' | 'PENDING' | 'IN_PROGRESS' | 'SCHEDULED'

## Response `200`

Campaigns retrieved successfully

- CampaignsListResponse
  - `message` string[]
  - `status` string
  - `data` object
    - `results` Campaign[]
      - `id` string
      - `name` string
      - `elementName` string
      - `botId` string
      - `status` 'PENDING' | 'SCHEDULED' | 'IN_PROGRESS' | 'COMPLETED'
      - `totalMessages` integer
      - `deliveredMessages` integer
      - `failedMessages` integer
      - `createdAt` string, date-time
      - `completedAt` string, date-time
    - `pagination` Pagination
      - `limit` integer
      - `page` integer
      - `total` integer
      - `offset` integer
      - `totalPages` integer

## Other responses

- `400` — Bad request - Invalid format or missing required fields
- `401` — Unauthorized - Invalid authentication credentials

---

[API](https://skmtc.net/jelou/apis/jelou-api.md) · [All operations](https://skmtc.net/jelou/apis/jelou-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jelou/jelou-api/revisions/845ce127d94a/schema)