Código 07 · Human verification in Peru

Returns the catalog of human verification services in Peru: USD prices, turnaround, coverage, today's remaining capacity, x402 payment details (network, asset, payTo) and hard limits. Call this first.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Returns the exact price, turnaround and today's remaining capacity for a service, or tells you it needs a custom quote. Does not create anything or charge anything.

{
  "type": "object",
  "properties": {
    "servicio": {
      "type": "string",
      "enum": [
        "verificacion_remota",
        "visita_presencial_lima",
        "personalizado"
      ],
      "description": "verificacion_remota = USD 25, 24 h (phone call in Spanish + SUNAT/RUC lookup + web check, anywhere in Peru). visita_presencial_lima = USD 75, 48 h (on-site visit in Metropolitan Lima/Callao, 6+ geotagged photos). personalizado = free quote request for anything else (e.g. visits outside Lima), paid later with pagar_solicitud."
    },
    "urgente": {
      "type": "boolean",
      "description": "Rush job: +50% price, half the turnaround.",
      "default": false
    },
    "ubicacion": {
      "type": "string",
      "description": "Address or city in Peru, if the task is on-site."
    }
  },
  "required": [
    "servicio"
  ],
  "additionalProperties": false
}

Books a vetted human verifier from the Código 07 network in Peru to check something in the physical world. The first available verifier accepts it and delivers a report with geotagged photos. Standard services are paid instantly and confirmed with no human approval. Payment: x402 v2 (v1 compatible), USDC on Base. Call once without payment to receive a PaymentRequired (isError=true, structuredContent). Retry the SAME call adding params._meta["x402/payment"] with the signed PaymentPayload. When it settles, the task is confirmed instantly with no human approval, and the result includes _meta["x402/payment-response"]. Returns id + token_consulta; store both. servicio "personalizado" (or an on-site visit outside Lima) creates a free quote request instead; pay it later with pagar_solicitud. Prohibited requests (surveillance of private individuals, entering private property, handling money/packages, impersonation, anything illegal) are rejected automatically before any charge.

{
  "type": "object",
  "properties": {
    "servicio": {
      "type": "string",
      "enum": [
        "verificacion_remota",
        "visita_presencial_lima",
        "personalizado"
      ],
      "description": "verificacion_remota = USD 25, 24 h (phone call in Spanish + SUNAT/RUC lookup + web check, anywhere in Peru). visita_presencial_lima = USD 75, 48 h (on-site visit in Metropolitan Lima/Callao, 6+ geotagged photos). personalizado = free quote request for anything else (e.g. visits outside Lima), paid later with pagar_solicitud."
    },
    "que_verificar": {
      "type": "string",
      "minLength": 10,
      "maxLength": 4000,
      "description": "What exactly must be verified, in Spanish or English. Be specific: the question to answer and why."
    },
    "ubicacion": {
      "type": "string",
      "maxLength": 500,
      "description": "Full address and district (for on-site visits) or city."
    },
    "ruc": {
      "type": "string",
      "pattern": "^[0-9]{11}$",
      "description": "Peruvian company tax ID (RUC, 11 digits), if relevant."
    },
    "entregable_esperado": {
      "type": "string",
      "maxLength": 1000,
      "description": "What you expect back (e.g. \"6 photos of storefront + yes/no on whether it is open\")."
    },
    "urgente": {
      "type": "boolean",
      "default": false,
      "description": "Rush job (+50%, half the turnaround)."
    },
    "agente": {
      "type": "string",
      "maxLength": 200,
      "description": "Name/identifier of your agent."
    },
    "contacto_email": {
      "type": "string",
      "format": "email",
      "description": "Optional. Inbox where status updates can be sent."
    },
    "contacto_whatsapp": {
      "type": "string",
      "maxLength": 30,
      "description": "Optional WhatsApp number with country code."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "description": "Optional https URL. Receives POST updates (cotizada, completada, cancelada) signed with X-Codigo07-Signature = sha256 HMAC of the raw body using your token_consulta."
    },
    "acepta_terminos": {
      "type": "boolean",
      "const": true,
      "description": "Must be true: you accept the terms and limits at https://codigo07.vercel.app/#terminos."
    }
  },
  "required": [
    "servicio",
    "que_verificar",
    "acepta_terminos"
  ],
  "additionalProperties": false
}

Pays a custom request once its status is "cotizada" and confirms it instantly. Payment: x402 v2 (v1 compatible), USDC on Base. Call once without payment to receive a PaymentRequired (isError=true, structuredContent). Retry the SAME call adding params._meta["x402/payment"] with the signed PaymentPayload. When it settles, the task is confirmed instantly with no human approval, and the result includes _meta["x402/payment-response"].

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Request id, e.g. C07-1A2B3C4D"
    },
    "token": {
      "type": "string",
      "description": "token_consulta returned when the request was created"
    }
  },
  "required": [
    "id",
    "token"
  ],
  "additionalProperties": false
}

Rates the verifier who completed a task (1 to 5 stars, optional comment). Ratings rank verifiers in the network. One rating per task.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Request id"
    },
    "token": {
      "type": "string",
      "description": "token_consulta"
    },
    "estrellas": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    },
    "comentario": {
      "type": "string",
      "maxLength": 1000
    }
  },
  "required": [
    "id",
    "token",
    "estrellas"
  ],
  "additionalProperties": false
}

Returns status (cotizacion_pendiente, cotizada, pago_en_proceso, pagada, en_proceso, completada, pago_fallido, rechazada, cancelada), price, delivery deadline, payment transaction, and when completed: the report (conclusion, details, geotagged photo URLs) plus a human-readable report URL.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Request id, e.g. C07-1A2B3C4D"
    },
    "token": {
      "type": "string",
      "description": "token_consulta returned when the request was created"
    }
  },
  "required": [
    "id",
    "token"
  ],
  "additionalProperties": false
}