> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # Canjear personas - Estado masivo > Comprueba el estado y los resultados de una solicitud de canje en lote enviada previamente. ## OpenAPI ````yaml es-openapi POST /redeem/people/batch/query openapi: 3.0.0 info: description: >- La API de Pubrio ofrece inteligencia de expansión de mercado —señales en tiempo real que indican cuándo una empresa entra en un nuevo mercado— junto con los datos de empresas y personas que las respaldan. Busca, consulta y enriquece cuentas y contactos, y suscríbete a señales de movimiento tipadas y fechadas en más de 200 mercados. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/es/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/es/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: Información del perfil del espacio de trabajo y estadísticas de uso - name: Enrichment description: Enriquece registros de personas y empresas con datos B2B detallados - name: Lookalike description: Encuentra empresas similares a una empresa determinada - name: Search description: Busca personas, empresas, empleos, noticias y anuncios con filtros - name: Lookup description: >- Consulta información detallada de personas, empresas, empleos, noticias, anuncios y tecnologías específicos - name: LinkedIn description: Consulta datos de personas y empresas mediante URL de perfil de LinkedIn - name: Redeem description: >- Canjea créditos para desbloquear datos de contacto de personas (individual y por lotes) - name: Channels description: >- Gestiona plantillas de canales de contacto (crear, actualizar, eliminar, listar) - name: Monitor description: >- Crea y gestiona monitores de datos con webhooks, estadísticas y procesamiento - name: Filters description: >- Obtén los valores de filtro disponibles para los parámetros de búsqueda (tecnologías, ubicaciones, verticales, etc.) - name: API Keys description: >- Lista e inspecciona los registros de solicitudes a la API y las analíticas de uso de las claves de API - name: Insights description: >- Información agregada de señales para empresas (empleos, noticias, anuncios). - name: Export description: Exportaciones de datos masivas (sujetas a créditos). - name: Expansion description: >- Inteligencia de expansión de mercado de empresas: señales, etapas, mercados y exportaciones. externalDocs: description: >- La API de Pubrio se utiliza para buscar, previsualizar y enriquecer contactos y cuentas. La base de datos de Pubrio ofrece amplios datos de contactos B2B e inteligencia de ventas. url: https://docs.pubrio.com paths: /redeem/people/batch/query: post: tags: - Redeem summary: Consultar el estado de un canje en lote description: >- Comprueba el estado y los resultados de una solicitud de canje en lote enviada previamente. operationId: redeem_people_batch_query parameters: [] requestBody: required: true content: application/json: schema: type: object properties: redeem_query_id: $ref: '#/components/schemas/redeem_query_id' required: - redeem_query_id responses: '200': description: >- Respuesta exitosa que contiene los detalles del canje masivo de personas. content: application/json: schema: type: object properties: data: allOf: - $ref: '#/components/schemas/data' properties: peoples: type: array description: >- Las personas canjeadas. `emails` y `phones` son `null` —no `[]`— cuando no se encuentra nada para esa persona, así que compruébalo antes de iterar. `total_credit_cost` refleja solo las coincidencias exitosas y es `0` cuando no se canjeó nada; el coste aumenta según cuántos tipos de contacto solicites. items: type: object example: data: profile: credit: 450376 topup_credit: 235237 total_charged_credit: 465 query: redeem_query_id: a046c1da-b3d4-4ca1-aca6-1dd8c8055701 is_completed: true estimated_time: 6 estimated_time_type: second peoples: - people_search_id: 540574d1-ff74-475b-aea2-f8ae643b806d emails: - value: example@gmail.com type: email-personal status: null - value: example@pubrio.com type: email-work status: Verified phones: - value: '+1123456789' type: phone status: null - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: redeem_query_id: type: string format: uuid description: >- Cuando se inicia una solicitud de canje masivo, se devuelve un `redeem_query_id`, que puede usarse aquí para obtener los resultados. data: type: object nullable: true description: La información de la respuesta depende del endpoint específico. responses: general_error: description: >- Solicitud incorrecta. La solicitud estaba mal formada o contenía parámetros no válidos. Consulta el código de error y el mensaje para más detalles. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- Límite de tasa excedido. Se realizaron demasiadas solicitudes en un período de tiempo determinado. Vuelve a intentarlo después de que se restablezca la ventana de límite de tasa. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- Error interno del servidor. Se produjo un error inesperado en el servidor. Contacta con soporte si el error persiste. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- Un token de API único que representa las acciones que realizas a través de la API, junto con los permisos y operaciones correspondientes. Puedes crearlo en la sección [Configuración](https://dashboard.pubrio.com/#/settings/). in: header ````