Skip to main content
GET
/
api
/
comunicados
curl -X GET "https://api.example.com/api/comunicados?limit=5" \
  -H "Authorization: Bearer YOUR_TOKEN"
[
  {
    "id_comunicado": 1,
    "titulo": "Welcome to the Portal",
    "contenido": "We are excited to announce the launch of our new self-service portal.",
    "fecha_publicacion": "2026-03-01T10:00:00Z",
    "activo": true,
    "media_url": "https://example.com/media/welcome.jpg",
    "fecha_creacion": "2026-02-28T15:30:00Z",
    "fecha_actualizacion": "2026-02-28T15:30:00Z"
  },
  {
    "id_comunicado": 2,
    "titulo": "System Maintenance Notice",
    "contenido": "Scheduled maintenance will occur on Saturday from 2 AM to 4 AM.",
    "fecha_publicacion": "2026-03-05T08:00:00Z",
    "activo": true,
    "media_url": null,
    "fecha_creacion": "2026-03-04T12:00:00Z",
    "fecha_actualizacion": "2026-03-04T12:00:00Z"
  }
]

Overview

This endpoint returns all active (published) announcements. Inactive or draft announcements are not included in the response. Optionally supports limiting the number of results.

Query Parameters

limit
integer
Maximum number of announcements to return. If not specified, returns all active announcements.

Response

comunicados
array
Array of active announcement objects
id_comunicado
integer
Unique identifier for the announcement
titulo
string
Title of the announcement
contenido
string
Content/body of the announcement
fecha_publicacion
string
Publication date in ISO 8601 format
activo
boolean
Whether the announcement is active (always true for this endpoint)
media_url
string
URL to associated media (image, video, etc.)
fecha_creacion
string
Creation timestamp in ISO 8601 format
fecha_actualizacion
string
Last update timestamp in ISO 8601 format
curl -X GET "https://api.example.com/api/comunicados?limit=5" \
  -H "Authorization: Bearer YOUR_TOKEN"
[
  {
    "id_comunicado": 1,
    "titulo": "Welcome to the Portal",
    "contenido": "We are excited to announce the launch of our new self-service portal.",
    "fecha_publicacion": "2026-03-01T10:00:00Z",
    "activo": true,
    "media_url": "https://example.com/media/welcome.jpg",
    "fecha_creacion": "2026-02-28T15:30:00Z",
    "fecha_actualizacion": "2026-02-28T15:30:00Z"
  },
  {
    "id_comunicado": 2,
    "titulo": "System Maintenance Notice",
    "contenido": "Scheduled maintenance will occur on Saturday from 2 AM to 4 AM.",
    "fecha_publicacion": "2026-03-05T08:00:00Z",
    "activo": true,
    "media_url": null,
    "fecha_creacion": "2026-03-04T12:00:00Z",
    "fecha_actualizacion": "2026-03-04T12:00:00Z"
  }
]

Get Announcement by ID

Retrieve a specific announcement by its ID

Create Announcement

Create a new announcement (Admin only)

Build docs developers (and LLMs) love