> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.kubifactu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Estado del servicio Veri*Factu

> Obtiene el estado actual del servicio Veri*Factu de la AEAT.

Este endpoint devuelve información sobre la disponibilidad del servicio, incluyendo el código de estado HTTP de la última comprobación y cualquier mensaje de error si el servicio no está disponible.




## OpenAPI

````yaml /api-reference/openapi/openapi.yaml get /api/verifactu/health
openapi: 3.0.0
info:
  title: Kubifactu API
  description: API para el procesamiento y gestión de facturas de Veri*Factu
  version: 1.0.0
  contact:
    email: soporte@kubifactu.com
    name: Soporte KubiFACTU
    url: https://apidocs.kubifactu.com
servers:
  - url: https://api.kubifactu.com
    description: Servidor de producción
  - url: https://devapi.kubifactu.com
    description: Servidor de pruebas
security: []
paths:
  /api/verifactu/health:
    get:
      summary: Estado del servicio Veri*Factu
      description: >
        Obtiene el estado actual del servicio Veri*Factu de la AEAT.


        Este endpoint devuelve información sobre la disponibilidad del servicio,
        incluyendo el código de estado HTTP de la última comprobación y
        cualquier mensaje de error si el servicio no está disponible.
      operationId: getVerifactuHealthStatus
      responses:
        '200':
          description: Estado del servicio Veri*Factu.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerifactuHealthCheckResponse'
        '403':
          description: No autorizado. La API-KEY proporcionada no es válida.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedApiKeyErrorResponse'
        '404':
          description: No hay registros de health check disponibles.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundErrorResponse'
        '500':
          description: Error interno del servidor.
      security:
        - client_api_key: []
components:
  schemas:
    VerifactuHealthCheckResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            available:
              type: boolean
              description: Indica si el servicio Veri*Factu está disponible.
              example: true
            http_status_code:
              type: integer
              nullable: true
              description: >-
                Código de estado HTTP devuelto por el servicio Veri*Factu en la
                última comprobación.
              example: 200
            error_message:
              type: string
              nullable: true
              description: >-
                Mensaje de error si el servicio no está disponible o ha fallado
                la comprobación.
              example: null
            environment:
              type: string
              description: >
                Entorno de Veri*Factu sobre el que se ha realizado la
                comprobación.

                Valores posibles: `PROD`, `DEV`.
              example: PROD
            checked_at:
              type: string
              format: date-time
              description: Fecha y hora de la última comprobación en formato ISO 8601.
              example: '2025-01-15T10:30:00+00:00'
    UnauthorizedApiKeyErrorResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            error:
              type: object
              properties:
                code:
                  type: string
                  description: Código de error que indica el tipo de problema.
                  example: E-UNAUTH-APIKEY
                message:
                  type: string
                  description: Mensaje detallado del error.
                  example: >-
                    No client with API-KEY
                    '5tVySMGJOpq8HfMgIX28Qz6kF0dFOoq37x55PLZcWsGeGeYkNgJyAcRTlFJ5NbVoDRm8qtCywEoiN3A9JkBanMBXYmxiqR3BItxgxx'
                    was found.
                http_code:
                  type: integer
                  description: Código HTTP asociado al error.
                  example: 403
                errors:
                  type: object
                  nullable: true
                  description: >
                    Detalles adicionales del error. Puede ser `null` si no hay
                    información específica.
                  example: null
                details:
                  type: object
                  properties:
                    request_id:
                      type: string
                      description: Identificador único de la solicitud para rastreo.
                      example: 2cc8ef846029ec69613711ad1d85f6dfebf16ffb
    NotFoundErrorResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            error:
              type: object
              properties:
                message:
                  type: string
                  description: Mensaje detallado del error.
                  example: >-
                    Client Company with id
                    [0195fa87-a315-710a-8aa2-25e1d690f6tr] not found.
                errors:
                  type: object
                  nullable: true
                  description: >
                    Detalles adicionales del error. Puede ser `null` si no hay
                    información específica.
                  example: null
                details:
                  type: object
                  properties:
                    request_id:
                      type: string
                      description: Identificador único de la solicitud para rastreo.
                      example: 2cc8ef846029ec69613711ad1d85f6dfebf16ffb
  securitySchemes:
    client_api_key:
      type: apiKey
      name: X-Qbikode-ClientApiKey
      in: header
      description: >
        API-KEY de la empresa que hace la petición. Este dato se puede consultar
        en el panel web, accediendo a la sección _Empresas_ y accediendo a la
        ficha de la empresa en.

````