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

# RUC

> Consulta RUC por número.



## OpenAPI

````yaml POST /ruc
openapi: 3.0.1
info:
  title: json.pe - API Consulta RUC, DNI, Placa, SOAT, Licencia de Conducir y más
  description: >-
    Documentación oficial de [json.pe](https://json.pe) — API Consulta RUC, DNI,
    Placa, SOAT, Licencia de Conducir y más. Regístrate gratis en
    [json.pe/signup](https://json.pe/signup).
  version: 1.0.0
servers:
  - url: https://api.json.pe/api
security:
  - bearerAuth: []
paths:
  /ruc:
    post:
      tags:
        - ruc
      description: Consulta RUC por número.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ruc-request'
      responses:
        '200':
          description: ruc response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ruc'
        '404':
          description: Recurso no encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example:
                success: false
                message: No se encontró RUC
components:
  schemas:
    ruc-request:
      type: object
      required:
        - ruc
      properties:
        ruc:
          type: string
          description: El RUC a consultar
          example: '20552103816'
      example:
        ruc: '20552103816'
    ruc:
      type: object
      properties:
        success:
          type: boolean
          description: El estado de la respuesta  true o false
        message:
          type: string
          description: Mensaje de la respuesta
        data:
          type: object
          description: Datos detallados de la respuesta
          properties:
            ruc:
              type: string
              description: Número de identificación (RUC)
            nombre_o_razon_social:
              type: string
              description: Nombre o Razon Social de la empresa
            estado:
              type: string
              description: Estado de la empresa
            condicion:
              type: string
              description: Condición de la empresa
            departamento:
              type: string
              description: Departamento de la empresa
            provincia:
              type: string
              description: Provincia de la empresa
            distrito:
              type: string
              description: Distrito de la empresa
            direccion:
              type: string
              description: Dirección específica
            direccion_completa:
              type: string
              description: >-
                Dirección completa, incluyendo distrito, provincia y
                departamento
            ubigeo_sunat:
              type: string
              description: Ubigeo según SUNAT
            ubigeo:
              type: array
              description: Ubigeo desglosado por componentes
              items:
                type: string
            es_agente_de_retencion:
              type: string
              description: Indica si es agente de retención
            es_agente_de_percepcion:
              type: string
              description: Indica si es agente de percepción
            es_agente_de_percepcion_combustible:
              type: string
              description: Indica si es agente de percepción de combustibles
            es_buen_contribuyente:
              type: string
              description: Indica si está catalogado como buen contribuyente
      example:
        success: true
        message: exito
        data:
          ruc: '20552103816'
          nombre_o_razon_social: AGROLIGHT PERU S.A.C.
          estado: SUSPENSION TEMPORAL
          condicion: HABIDO
          departamento: LIMA
          provincia: LIMA
          distrito: SANTA ANITA
          direccion: PJ. JORGE BASADRE NRO. 158 URB. POP LA UNIVERSAL 2DA ET.
          direccion_completa: >-
            PJ. JORGE BASADRE NRO. 158 URB. POP LA UNIVERSAL 2DA ET., LIMA -
            LIMA - SANTA ANITA
          ubigeo_sunat: '150137'
          ubigeo:
            - '15'
            - '1501'
            - '150137'
          es_agente_de_retencion: 'NO'
          es_agente_de_percepcion: 'NO'
          es_agente_de_percepcion_combustible: 'NO'
          es_buen_contribuyente: SI
    error:
      required:
        - message
        - success
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
      example:
        success: false
        message: Bad Request
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````