> ## 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 - Razón Social

> Búsqueda por razón social.



## OpenAPI

````yaml POST /ruc/razon_social
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/razon_social:
    post:
      tags:
        - ruc
      description: Búsqueda por razón social.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ruc-razon-social-request'
      responses:
        '200':
          description: >-
            Búsqueda exitosa. Retorna lista de empresas que coinciden con la
            razón social.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ruc-razon-social'
        '404':
          description: Recurso no encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example:
                success: false
                message: No se encontraron resultados
components:
  schemas:
    ruc-razon-social-request:
      type: object
      required:
        - razon_social
      properties:
        razon_social:
          type: string
          description: La razón social a buscar
          example: BBVA
      example:
        razon_social: BBVA
    ruc-razon-social:
      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: array
          description: Lista de empresas que coinciden con la razón social
          items:
            type: object
            properties:
              ruc:
                type: string
                description: RUC de la empresa
              nombre_o_razon_social:
                type: string
                description: Nombre o razón social de la empresa
              ubicacion:
                type: string
                description: Ubicación de la empresa
              estado:
                type: string
                description: Estado de la empresa (ACTIVO, etc.)
      example:
        success: true
        message: exito
        data:
          - ruc: '20614570114'
            nombre_o_razon_social: BBVA.
            ubicacion: LIMA
            estado: ACTIVO
    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

````