# Listar Publicaciones

> Lista las Publicaciones de apps de Applivery usando la Integrations API o la Workspace API. Recupera IDs de Publicaciones y metadatos.

Source: https://docs.applivery.com/es/app-distribution/api/publications/list-publications/  •  Last updated: 2026-06-08

**Answers:** ¿Cómo listo las publicaciones de una sola app? · ¿Cómo listo publicaciones de varias apps a la vez? · ¿Qué autenticación requiere la Integrations API para listar publicaciones? · ¿Qué autenticación requiere la Workspace API para listar publicaciones? · ¿Cuál es el endpoint de la Integrations API para listar publicaciones? · ¿Cuál es el endpoint de la Workspace API para listar publicaciones? · ¿Qué parámetros de consulta puedo usar para filtrar publicaciones? · ¿Qué representa el campo id en la respuesta de lista de publicaciones?

---

**TL;DR:** Lista las publicaciones de tus aplicaciones en Applivery usando la API de Integraciones (por app) o la API de Workspace (multi-app).

Devuelve una lista paginada de Publicaciones para una App determinada. Usa este endpoint para consultar el estado actual de tus Publicaciones, obtener los valores `publishedApplicationId` que necesitan otros endpoints, o construir dashboards y scripts de automatización que actúen sobre Publicaciones específicas.

Applivery proporciona dos APIs independientes para listar Publicaciones, cada una con una credencial de autenticación diferente.

---

## Cómo elegir la API correcta

| | Integrations API | Workspace API |
|---|---|---|
| **Diseñada para** | Integraciones por app y pipelines de CI/CD | Automatización a nivel de Workspace en varias Apps |
| **Autenticación** | App API Token (por app) | token de una cuenta de servicio (a nivel de Workspace) |
| **Contexto de app** | Implícito — el token ya está vinculado a una App | Explícito — se requieren `organizationId` y `storeId` en la ruta |
| **Usuarios típicos** | Scripts que buscan el ID de una Publicación antes de actualizarla | Platform engineers que consultan Publicaciones de varias Apps |

:::warning
El acceso a las distintas APIs puede no estar disponible en tu plan actual. Consulta la disponibilidad en nuestra [página de precios](https://www.applivery.com/app-distribution-pricing/).
:::

---

## Integrations API

Usa este endpoint para listar Publicaciones dentro del ámbito de una sola app. La autenticación usa un **App API Token**, vinculado a la App específica.

Para crear un App API Token, consulta [Autenticación de la API de Apps](https://docs.applivery.com/en/app-distribution/api/app-api-token/).

### Endpoint

```
GET https://api.applivery.io/v1/integrations/distributions
```

### Autenticación

```
Authorization: Bearer <your_app_token>
```

### Parámetros de consulta

Todos los parámetros son opcionales. Sin filtros, el endpoint devuelve todas las Publicaciones de la App asociada al token.

| Parámetro | Tipo | Descripción |
|---|---|---|
| `slug` | String | Filtra por slug de la Publicación. Devuelve solo la Publicación que coincide exactamente con este slug. |
| `security` | String | Filtra por modo de seguridad. Valores permitidos: `public`, `password`, `logged`. |
| `visibility` | String | Filtra por estado de visibilidad. Valores permitidos: `active`, `inactive`, `unlisted`. |
| `filter-type` | String | Filtra por estrategia de selección de Build. Valores permitidos: `last`, `build`, `builds`, `gitBranch`, `gitTag`, `tag`. |
| `page` | Integer | Número de página para paginación. Empieza en `1`. |
| `limit` | Integer | Número máximo de Publicaciones a devolver por página. |

### Ejemplo de petición

```bash
curl 'https://api.applivery.io/v1/integrations/distributions?visibility=active&security=public' \
  -X GET \
  -H 'Authorization: Bearer YOUR_APP_TOKEN'
```

### Respuestas

**✓ 200 OK**

```json
{
  "status": true,
  "data": {
    "items": [
      {
        "id": "string",
        "updatedAt": "2025-10-23T07:54:26.518Z",
        "createdAt": "2024-07-23T08:10:46.471Z",
        "application": "string",
        "applicationInfo": {
          "id": "string",
          "slug": "string",
          "name": "string",
          "picture": "string"
        },
        "slug": "string",
        "filter": {
          "type": "last",
          "value": "string",
          "ios": "string",
          "android": "string",
          "windows": "string",
          "macos": "string",
          "builds": [
            {
              "buildPlatform": "string",
              "id": "string"
            }
          ]
        },
        "security": "public",
        "tags": ["string"],
        "groups": [["string"]],
        "activateUserAudiences": false,
        "userAudienceMap": [],
        "visibility": "active",
        "showHistory": false,
        "showDevInfo": false,
        "expirationDate": "string",
        "distributionUrl": "string",
        "terms": {
          "active": true,
          "text": "string"
        },
        "configuration": {
          "branding": {
            "logo": "string",
            "primaryColor": "string",
            "useAppIcon": false
          },
          "application": {
            "description": "string",
            "name": "string"
          }
        },
        "allowedCountries": [],
        "blockedCountries": []
      }
    ],
    "totalDocs": 0,
    "limit": 0,
    "hasPrevPage": true,
    "hasNextPage": true,
    "page": 0,
    "totalPages": 0,
    "pagingCounter": 0,
    "prevPage": 0,
    "nextPage": 0
  }
}
```

**✗ 401 Unauthorized**

```json
{
  "status": false,
  "error": {
    "code": 4002,
    "message": "No auth token"
  }
}
```

**✗ 404 Not Found**

```json
{
  "status": false,
  "error": {
    "code": 3001,
    "message": "Entity not found"
  }
}
```

### Campos principales de la respuesta

| Campo | Descripción |
|---|---|
| `id` | El identificador único de la Publicación (`publishedApplicationId`). Úsalo en los endpoints [PUT – Actualizar](https://docs.applivery.com/en/app-distribution/api/publications/update-publication/) y [DELETE](https://docs.applivery.com/en/app-distribution/api/publications/delete-publication/). |
| `slug` | El identificador amigable para URL que forma parte de la URL de la Publicación. |
| `distributionUrl` | La URL pública completa de la Publicación. Compártela con tus usuarios para darles acceso. |
| `security` | Modo de seguridad actual: `public`, `password` o `logged`. |
| `visibility` | Estado de visibilidad actual: `active`, `inactive` o `unlisted`. |
| `filter.type` | Estrategia de selección de Build configurada: `last`, `build`, `builds`, `gitBranch`, `gitTag` o `tag`. |
| `expirationDate` | Timestamp ISO 8601 a partir del cual la Publicación deja de estar disponible. `null` si no hay fecha de caducidad. |
| `activateUserAudiences` | Si el control de acceso basado en audiencias está habilitado para esta Publicación. |
| `userAudienceMap` | Array de asignaciones de audiencias para esta Publicación. |
| `allowedCountries` | Códigos de país desde los que se permite explícitamente el acceso. Array vacío significa sin restricción. |
| `blockedCountries` | Códigos de país desde los que se bloquea explícitamente el acceso. Array vacío significa sin restricción. |
| `configuration` | Sobreescrituras de branding y nombre/descripción de app aplicadas a esta Publicación. |
| `terms` | Configuración de términos legales — si se requiere aceptación y el texto de los términos. |

### Campos de paginación

| Campo | Descripción |
|---|---|
| `totalDocs` | Número total de Publicaciones que coinciden con la consulta. |
| `page` | Número de página actual. |
| `totalPages` | Número total de páginas. |
| `limit` | Número de resultados por página. |
| `hasNextPage` | Si hay una página siguiente de resultados. |
| `hasPrevPage` | Si hay una página anterior de resultados. |
| `nextPage` | Número de la página siguiente, o `null` si estás en la última página. |
| `prevPage` | Número de la página anterior, o `null` si estás en la primera página. |

---

## Workspace API

Usa este endpoint para listar Publicaciones a nivel de Workspace — por ejemplo, en pipelines de automatización que operan en varias Apps usando una sola credencial.

La autenticación usa un token de **cuenta de servicio**, con ámbito de Workspace y no vinculado a ninguna app individual.

Para crear un token de una cuenta de servicio, consulta [Cuenta de servicio](https://docs.applivery.com/en/platform/api/service-accounts/).

### Endpoint

```
GET https://api.applivery.io/v1/organizations/{organizationId}/stores/{storeId}/pubApps
```

### Parámetros de ruta

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `organizationId` | String | Sí | El identificador único de tu organización en Applivery. |
| `storeId` | String | Sí | El identificador único de la store (proyecto de app) cuyas Publicaciones quieres listar. |

### Autenticación

```
Authorization: Bearer <your_service_account_token>
```

### Parámetros de consulta

La Workspace API acepta los mismos parámetros de consulta que la Integrations API.

### Ejemplo de petición

```bash
curl 'https://api.applivery.io/v1/organizations/ORG_ID/stores/STORE_ID/pubApps?visibility=active' \
  -X GET \
  -H 'Authorization: Bearer YOUR_SERVICE_ACCOUNT_TOKEN'
```

El esquema de respuesta es idéntico al de la Integrations API.