> ## 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.

# Consultar la validez de un NIF/CIF

> Hace un consulta al **Web Service de Calidad de datos identificativos** de la AEAT para validar la existencia de un NIF/CIF.




## OpenAPI

````yaml /api-reference/openapi/openapi-common.yaml get /api/id-query?nif={nif}&name={name}
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/id-query?nif={nif}&name={name}:
    get:
      summary: Consultar la validez de un NIF/CIF
      description: >
        Hace un consulta al **Web Service de Calidad de datos identificativos**
        de la AEAT para validar la existencia de un NIF/CIF.
      parameters:
        - name: nif
          in: query
          description: NIF/CIF sobre el que se quiere hace la consulta.
          required: true
          schema:
            type: string
            example: 42439999P
        - name: name
          in: query
          description: >
            Nombre de la persona jurídica o física que se quiere consultar. Este
            campo sólo es obligatorio si la consulta es sobre un **persona
            física**.
          required: false
          schema:
            type: string
            example: ANTONIO LÓPEZ JUSTO
      responses:
        '200':
          description: Respuesta del Web Service de Calidad de datos identificativos.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdentificationDocumentResponse'
        '403':
          description: No autorizado. La API-KEY proporcionada no es válida.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedApiKeyErrorResponse'
        '500':
          description: Error interno del servidor.
        '502':
          description: >-
            Problema en el servidor del Web Service de Calidad de datos
            identificativos.
      security:
        - client_api_key: []
components:
  schemas:
    IdentificationDocumentResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            nif:
              type: string
              description: NIF/CIF.
              example: 42439999P
            name:
              type: string
              description: Nombre de la persona física/jurídica asociada al NIF/CIF.
              example: ANTONIO LÓPEZ JUSTO
            document_type:
              $ref: '#/components/schemas/IdentificationDocumentType'
            result:
              $ref: '#/components/schemas/IdentificationDocumentQueryResult'
    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
    IdentificationDocumentType:
      nullable: true
      type: string
      description: >
        Indica si el documento de identificación es de persona física o de
        persona jurídica:


        - `legal_entity`: persona jurídica.

        - `natural_person`: persona física.
      enum:
        - legal_entity
        - natural_person
    IdentificationDocumentQueryResult:
      type: string
      description: >
        Estado de registro en el censo de la AEAT para los datos de la consulta.
        Valores posibles:


        - `identificado`

        - `no-identificado`
      enum:
        - identificado
        - no-identificado
  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.

````