# Listar Builds > Lista las Builds de una App usando la API de Applivery. Cubre tanto la Integrations API como la Workspace API para consultar el historial y el estado de las Builds. Source: https://docs.applivery.com/es/app-distribution/api/builds/list-builds/ • Last updated: 2026-06-08 **Answers:** ¿Cuáles son las dos APIs de Applivery para listar builds? · ¿Cuándo debo usar la Integrations API para listar builds? · ¿Cuándo debo usar la Workspace API para listar builds? · ¿Cómo me autentico con la Integrations API? · ¿Cómo me autentico con la Workspace API? · ¿Qué parámetros puedo usar para filtrar builds en la Integrations API? · ¿Qué parámetros de ruta requiere la Workspace API? · ¿Cómo puedo comprobar el estado de procesamiento de una build? --- **TL;DR:** Lista las builds de tus apps usando la API de Integraciones o la API de Workspace de Applivery con la autenticación correspondiente. Devuelve una lista paginada de Builds para una App determinada. Resulta útil para consultar el historial de builds, comprobar el estado de procesamiento tras una subida, o crear dashboards y scripts de automatización que actúen sobre Builds específicos. Applivery proporciona dos APIs independientes para listar Builds, 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, pipelines de CI/CD, herramientas de build | Automatización a nivel de Workspace en varias Apps | | **Autenticación** | App API Token (por app) | un token de una cuenta de servicio (a nivel de Workspace) | | **URL base** | `https://api.applivery.io` | `https://api.applivery.io` | | **Contexto de app** | Implícito — el token ya está vinculado a una App | Explícito — se requieren `organizationId` y `applicationId` en la ruta | | **Usuarios típicos** | Scripts que comprueban el estado de la Build, polling tras subida | Platform engineers que consultan Builds en 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 consultar Builds 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/builds ``` ### Autenticación ``` Authorization: Bearer ``` ### Parámetros de consulta Todos los parámetros son opcionales. Sin filtros, el endpoint devuelve todos las Builds de la App asociada al token, ordenados por fecha de creación descendente. | Parámetro | Tipo | Descripción | |---|---|---| | `versionName` | String | Filtra por nombre de versión legible. P. ej., `RC-1`, `v2.4.0-beta`. | | `status` | String | Filtra por estado de procesamiento. Valores admitidos: `pending`, `in_progress`, `processed`, `error`. | | `os` | String | Filtra por sistema operativo. Valores admitidos: `ios`, `android`. | | `page` | Integer | Número de página para la paginación. Empieza en `1`. | | `limit` | Integer | Número máximo de Builds a devolver por página. | ### Ejemplo de petición ```bash curl 'https://api.applivery.io/v1/integrations/builds?status=processed&os=ios&page=1&limit=20' \ -X GET \ -H 'Authorization: Bearer YOUR_APP_TOKEN' ``` ### Respuestas **✓ 200 OK** ```json { "status": true, "data": { "items": [ { "id": "string", "status": "processed", "tags": ["string"], "versionName": "string", "application": "string", "applicationInfo": { "id": "string", "name": "string", "slug": "string", "picture": "string" }, "changelog": "string", "info": { "icon": "string", "android": { "targetSdkVersion": "string", "minSDKVersion": "string", "packageName": "string", "platformBuildVersionName": "string", "platformBuildVersionCode": "string", "versionName": "string", "versionCode": "string", "icon": "string" }, "ios": { "plist": { "CFBundleDisplayName": "string", "CFBundleSupportedPlatforms": ["string"], "MinimumOSVersion": "string", "CFBundleIdentifier": "string", "CFBundleShortVersionString": "string", "CFBundleVersion": "string", "CFBundleName": "string", "CFBundleIcons": ["string"], "UIDeviceFamily": ["string"] }, "mobileprovision": { "ExpirationDate": "2019-08-24T14:15:22Z", "TeamIdentifier": "string", "ProvisionsAllDevices": true, "TeamName": "string", "ProvisionedDevices": "string", "signingType": "ad-hoc" } }, "pkg": { "CFBundleDisplayName": "string", "CFBundleIdentifier": "string", "CFBundleShortVersionString": "string", "CFBundleVersion": "string", "CFBundleName": "string" } }, "size": 0, "processTime": 0, "queuedTime": 0, "versionCode": "string", "error": "string", "errorCode": "string", "os": "ios", "deployer": { "name": "string", "info": { "commitMessage": "string", "commit": "string", "branch": "string", "triggerTimestamp": "string", "buildUrl": "string", "ciUrl": "string", "repositoryUrl": "string", "buildNumber": "string", "tag": "string" } }, "uploadedBy": { "id": "string", "email": "user@example.com", "firstName": "string", "lastName": "string", "picture": "string" }, "originalExtension": "string", "storageProvider": { "id": "string", "name": "string", "region": "string" }, "hasEmmJson": true, "updatedAt": "2019-08-24T14:15:22Z", "createdAt": "2019-08-24T14:15:22Z" } ] } } ``` **✗ 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" } } ``` :::tip Usa `status=pending` o `status=in_progress` para hacer polling de Builds que aún se están procesando tras una subida. Una vez que el `status` devuelva `processed`, la Build está lista. Si el `status` es `error`, consulta los campos `error` y `errorCode` para más detalles, y revisa los [Códigos de procesamiento de Builds](https://docs.applivery.com/en/app-distribution/builds/processing-error-codes/) para los pasos de resolución. ::: --- ## Workspace API Usa este endpoint para consultar Builds a nivel de Workspace — por ejemplo, en flujos de trabajo de platform engineering donde una sola credencial necesita listar Builds en varias Apps. La autenticación usa un token de **cuenta de servicio**, con ámbito de Workspace y no vinculado a ninguna app individual. El contexto de la app se proporciona explícitamente mediante parámetros de ruta. Para crear un token de una cuenta de servicio, consulta [Cuentas de servicio](https://docs.applivery.com/en/platform/api/service-accounts/). ### Endpoint ``` GET https://api.applivery.io/v1/organizations/{organizationId}/apps/{applicationId}/builds ``` ### Parámetros de ruta | Parámetro | Tipo | Obligatorio | Descripción | |---|---|---|---| | `organizationId` | String | Sí | El identificador único de tu organización en Applivery. | | `applicationId` | String | Sí | El identificador único de la App cuyos Builds quieres listar. | ### Autenticación ``` Authorization: Bearer ``` ### 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/apps/APP_ID/builds?status=processed&os=android&page=1&limit=10' \ -X GET \ -H 'Authorization: Bearer YOUR_SERVICE_ACCOUNT_TOKEN' ```