Consulta Transporte de Mercancías

Datos de una empresa de transporte de mercancías y su flota (Registro MTC).

Consideraciones

Devuelve los datos completos de una empresa del Registro Nacional de Transporte de Mercancías (empresa + flota), buscando por RUC, partida, placa o constancia (consulta directa a MTC).
No disponible en el plan gratuito. Consume 5 consultas de tu plan.

POST https://api.apiperu.dev/transporte-mercancias Copiar

Headers

Name	Type	Description
Accept	String	application/json
Content-Type	string	application/json
Authorization	string	Bearer <token>. Genéralo desde tu panel, en `Api Tokens`.

Body

Name	Type	Description
tipo*	string	Criterio de búsqueda: `ruc`, `partida`, `placa` o `constancia`.
valor*	string	El valor a buscar, según el `tipo` indicado.

Ejemplo de solicitud

Copiar

curl -X POST https://api.apiperu.dev/transporte-mercancias \
  -H "Accept: application/json" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tipo":"ruc","valor":"20601234567"}'

Copiar

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.apiperu.dev/transporte-mercancias',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => json_encode([
        'tipo' => 'ruc',
        'valor' => '20601234567',
    ]),
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Authorization: Bearer TU_TOKEN',
        'Content-Type: application/json',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

Copiar

const response = await fetch('https://api.apiperu.dev/transporte-mercancias', {
  method: 'POST',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer TU_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tipo: 'ruc',
    valor: '20601234567',
  }),
});

const data = await response.json();
console.log(data);

Copiar

import requests

response = requests.post(
    'https://api.apiperu.dev/transporte-mercancias',
    headers={
        'Accept': 'application/json',
        'Authorization': 'Bearer TU_TOKEN',
        'Content-Type': 'application/json',
    },
    json={
        'tipo': 'ruc',
        'valor': '20601234567',
    },
)

print(response.json())

Respuesta

200 OK application/json

{
  "success": true,
  "data": {
    "empresa": {
      "partida": "51234567",
      "razon_social": "TRANSPORTES DEL SUR S.A.C.",
      "ruc": "20601234567",
      "estado": "VIGENTE",
      "vigente_hasta": "2028-12-31"
    },
    "vehiculos": [
      {
        "item": 1,
        "placa": "ABC123",
        "numero_constancia": "C-0001",
        "categoria": "N3",
        "anio_fabricacion": "2018",
        "carga_util": 12000
      }
    ],
    "total_vehiculos": 1
  },
  "time": 2.4
}