> ## Documentation Index > Fetch the complete documentation index at: https://docs.inagent.inconcertcx.com/llms.txt > Use this file to discover all available pages before exploring further. # Consultar direcciones bloqueadas > Lista las direcciones excluidas de la marcación en la cuenta. Devuelve las direcciones que no deben marcarse en ningún lote de la cuenta. ## OpenAPI ````yaml api-reference/dialer/openapi.yaml GET /blocked-addresses openapi: 3.1.0 info: title: AutoContact API version: final summary: Gestión de lotes de marcación automática y carga de contactos. description: > API de AutoContact: gestión de lotes de marcación automática y de los contactos que los integran. Todos los recursos se publican bajo `/autocontact/api/v1/`. ## Autenticación Las peticiones se autentican con el header `apikey`. La misma credencial permite operar los lotes de la cuenta a los que tenga acceso. El servicio deriva la cuenta de esa credencial y verifica que el recurso solicitado le pertenezca. Un lote que no pertenece a la cuenta responde `404`, igual que un lote inexistente. ## Operaciones asíncronas Algunas operaciones responden `202` en lugar de `200`: la petición se acepta y el trabajo continúa en segundo plano. Es el caso de la carga de contactos, el arranque y la eliminación de un lote. Esas respuestas incluyen un `operationId` que se consulta en `GET /batches/operations/{operationId}` para conocer el resultado. `POST /batches` no genera una operación: devuelve directamente el `batchId`, el estado `created` y el origen del lote, sin `operationId`. Tiempo de retención de las operaciones: | Tipo de operación | Disponible durante | |---|---| | Carga de contactos | 6 horas | | Ciclo de vida del lote (arranque, archivado, eliminación) | 1 hora, y 10 minutos desde que finaliza | ## Reintentos seguros con `Idempotency-Key` Las operaciones de escritura aceptan el header opcional `Idempotency-Key`. Resuelve el caso en que se produce un error de red después de que la petición llegó al servicio: sin este header no es posible determinar si el trabajo se procesó, y reintentar podría duplicar llamadas telefónicas. Con el header, un reintento que use la misma clave y el mismo cuerpo devuelve la respuesta original sin procesar nada de nuevo. Las claves se conservan 24 horas. Recomendación de uso: generar un identificador único (por ejemplo un UUID) antes del primer intento y reutilizarlo solo en los reintentos de esa misma operación. Requisitos de la clave: entre 1 y 255 caracteres, solo ASCII imprimible. Una clave que no cumpla estos requisitos se rechaza con `400 INVALID_IDEMPOTENCY_KEY` en lugar de ignorarse, para evitar procesar la petición sin la protección que el cliente espera tener. ### Headers de respuesta | Header | Cuándo aparece | Significado | |---|---|---| | `Idempotency-Replayed: true` | En un reintento | La respuesta corresponde a la petición original; no se procesó de nuevo | | `Retry-After` | Junto a `409 IDEMPOTENCY_KEY_IN_FLIGHT` | Segundos a esperar antes de reintentar | | `Idempotency-Status: bypassed` | Excepcionalmente | La petición se procesó **sin** protección de idempotencia | El header `Idempotency-Status: bypassed` indica que el servicio de idempotencia no estaba disponible y la petición se procesó igualmente, para no interrumpir la operación. La respuesta es válida, pero esa petición concreta no quedó protegida: si no se recibe respuesta, se recomienda verificar el estado antes de reintentar. Las respuestas con error `5xx` no se almacenan, de modo que un reintento con la misma clave vuelve a procesar la petición. servers: - url: https://api.backend.inconcertcc.com/autocontact/api/v1 description: API de Inagent security: - ApiKeyAuth: [] tags: - name: Lotes description: | Creación, consulta y control de lotes de marcación. - name: Contactos description: | Carga de contactos en un lote, reagendamiento y anulación. - name: Direcciones bloqueadas description: | Direcciones excluidas de la marcación en toda la cuenta. - name: Operaciones description: | Seguimiento de las operaciones asíncronas que devuelven `202`. paths: /blocked-addresses: get: tags: - Direcciones bloqueadas summary: Lista las direcciones bloqueadas description: > Devuelve las direcciones bloqueadas de la cuenta, paginadas. El parámetro `page` comienza en 0. El tamaño de página predeterminado es 50. operationId: listBlockedAddresses parameters: - name: addressType in: query description: Filtra por tipo de dirección. schema: type: string enum: - phone - email - whatsapp - name: page in: query description: Número de página, comenzando en 0. schema: type: integer minimum: 0 default: 0 - name: size in: query description: Número de direcciones por página. schema: type: integer minimum: 1 default: 50 responses: '200': description: Página de direcciones bloqueadas. content: application/json: schema: type: object required: - data - pagination properties: data: type: array items: $ref: '#/components/schemas/BlockedAddress' pagination: type: object required: - total - page - limit properties: total: type: integer description: >- Número total de direcciones bloqueadas que cumplen el filtro. example: 428 page: type: integer example: 0 limit: type: integer example: 50 example: data: - id: 6b1e4d90-8c2a-4f73-b5e1-9d0a3c7f2b48 address: '5491155551234' addressType: phone reason: Solicitud del titular blockedBy: user@example.com createdAt: '2026-08-04T10:15:00.000Z' updatedAt: '2026-08-04T10:15:00.000Z' pagination: total: 428 page: 0 limit: 50 '500': $ref: '#/components/responses/InternalError' components: schemas: BlockedAddress: type: object description: | Dirección excluida de la marcación en toda la cuenta. properties: id: type: string format: uuid address: type: string description: > Dirección bloqueada, normalizada en minúsculas y sin espacios en los extremos. example: '5491155551234' addressType: type: string enum: - phone - email - whatsapp description: > Tipo de dirección. Junto con `address` identifica el bloqueo de forma única. reason: type: - string - 'null' description: Motivo del bloqueo, si se indicó al registrarlo. example: Solicitud del titular blockedBy: type: string description: Usuario que registró el bloqueo. example: user@example.com createdAt: type: string format: date-time updatedAt: type: string format: date-time SimpleError: type: object required: - message description: > Error con mensaje descriptivo. Algunos traen `code` estable (los más nuevos); otros solo `message`. Los mensajes pueden aparecer en español o en inglés según el caso, y algunos errores todavía no incluyen `code`. Cuando esté presente, utilice `code` para tratar el error de forma programática. properties: code: type: string description: > Presente en los errores ya normalizados (`MISSING_PARAMETER`, `OPERATION_NOT_FOUND`, `VALIDATION_FAILED`, `INVALID_IDEMPOTENCY_KEY`, y los de idempotencia). message: type: string responses: InternalError: description: Error interno. content: application/json: schema: $ref: '#/components/schemas/SimpleError' securitySchemes: ApiKeyAuth: type: apiKey in: header name: apikey description: API key obtenida desde la interfaz de Inagent, dentro del marcador. ````