Consulta de RUC | Apachiy by Mytems

Endpoint

GET/api/v1/consulta/ruc/20{dni}9

URL base: https://apachiy.mytems.cloud

Autenticación

Envía tu token en el encabezado Authorization. El permiso consultas:ruc debe estar habilitado para tu cuenta.

Authorization: Bearer myt_live_TU_TOKEN

Genera el token desde el panel. Guárdalo como secreto y no lo expongas en el navegador, repositorios ni aplicaciones móviles.

Parámetros de ruta

Nombre	Tipo	Requerido	Descripción
`ruc`	string	Sí	Número de RUC de 11 dígitos.

Ejemplo de solicitud

Cambia el token y los datos de ejemplo por los de tu cuenta.

cURL

curl --request GET \
  --url "https://apachiy.mytems.cloud/api/v1/consulta/ruc/20123456789" \
  --header "Authorization: Bearer myt_live_TU_TOKEN" \
  --header "Accept: application/json"

import requests

url = "https:\/\/apachiy.mytems.cloud\/api\/v1\/consulta\/ruc\/20123456789"
headers = {"Authorization": "Bearer myt_live_TU_TOKEN", "Accept": "application/json"}
response = requests.get(url, headers=headers, timeout=30)
print(response.status_code, response.json())

const response = await fetch('https://apachiy.mytems.cloud/api/v1/consulta/ruc/20123456789', {
  headers: {
    Authorization: 'Bearer myt_live_TU_TOKEN',
    Accept: 'application/json',
  },
});

console.log(response.status, await response.json());

<?php

$url = 'https://apachiy.mytems.cloud/api/v1/consulta/ruc/20123456789';
$curl = curl_init($url);
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer myt_live_TU_TOKEN', 'Accept: application/json'],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
echo $status . ' ' . $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "time"
)

func main() {
    req, err := http.NewRequest("GET", "https:\/\/apachiy.mytems.cloud\/api\/v1\/consulta\/ruc\/20123456789", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", "Bearer myt_live_TU_TOKEN")
    req.Header.Set("Accept", "application/json")
    client := &http.Client{Timeout: 30 * time.Second}
    res, err := client.Do(req)
    if err != nil { panic(err) }
    defer res.Body.Close()
    responseBody, err := io.ReadAll(res.Body)
    if err != nil { panic(err) }
    fmt.Println(res.StatusCode, string(responseBody))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class Main {
    public static void main(String[] args) throws Exception {
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https:\/\/apachiy.mytems.cloud\/api\/v1\/consulta\/ruc\/20123456789"))
            .timeout(Duration.ofSeconds(30))
            .header("Authorization", "Bearer myt_live_TU_TOKEN")
            .header("Accept", "application/json")
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();
        var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode() + " " + response.body());
    }
}

require 'net/http'
require 'uri'

uri = URI('https://apachiy.mytems.cloud/api/v1/consulta/ruc/20123456789')
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer myt_live_TU_TOKEN'
request['Accept'] = 'application/json'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https', read_timeout: 30) { |http| http.request(request) }
puts "#${response.code} #${response.body}"

Respuesta

Estructura real de la respuesta HTTP 200; los valores entre llaves son marcadores de ejemplo.

200 · application/json

{
    "success": true,
    "data": {
        "tipo_documento": "RUC",
        "documento": "{ruc_consultado}",
        "nombre_o_razon_social": "{razon_social_devuelta}",
        "direccion": null,
        "ubigeo": {
            "codigo": null,
            "departamento": null,
            "provincia": null,
            "distrito": null,
            "catalogo": "INEI"
        },
        "estado_contribuyente": "{codigo_devuelto_por_sunat}",
        "condicion_domicilio": "{codigo_devuelto_por_sunat}",
        "correo": null,
        "telefonos": [],
        "tributos": []
    },
    "request_id": "{uuid_generado_por_la_api}"
}

Los datos devueltos pueden variar según la información disponible. Conserva el request_id para consultar el registro de una solicitud.

Errores y límites

Los errores controlados siguen la estructura { "success": false, "error": { "code": "...", "message": "..." } }. Según el caso, puedes recibir 401 por token inválido, 403 por permiso o servicio inactivo, 422 por datos no válidos y 429 por límite alcanzado.

Las consultas se limitan por el cupo mensual de tu plan y por el límite temporal de solicitudes. Revisa el código de error antes de reintentar.