API Reference

API REST.

Accede a consentimientos, dominios y certificados desde tus propios sistemas. Disponible en planes Starter, Pro y Enterprise.

Autenticación

Todas las peticiones requieren un API key en el header Authorization. Genera tu API key en Settings → API Keys.

curl
curl https://api.conma.lat/v1/domains \
  -H "Authorization: Bearer ck_live_TU_API_KEY"

Base URL

https://api.conma.lat/v1

Formato

JSON (application/json)

Rate limit

1.000 req/min por API key

Endpoints

GET/api/v1/consent/{id}

Obtiene el registro de consentimiento por ID de verificación.

Parámetros

idstringrequeridoID único del consentimiento (verifyKey)

Respuesta ejemplo

{
  "id": "ck_abc123",
  "tenantId": "ten_xyz",
  "domainId": "dom_123",
  "purposes": {
    "analytics": true,
    "marketing": false,
    "preferences": true
  },
  "createdAt": "2026-05-14T10:30:00Z",
  "ipHash": "sha256:a1b2c3..."
}
GET/api/v1/consents

Lista los consentimientos del dominio con paginación.

Parámetros

domainIdstringrequeridoID del dominio
pagenumberPágina (por defecto: 1)
limitnumberResultados por página (máx. 100)
fromstringFecha de inicio ISO 8601
tostringFecha de fin ISO 8601

Respuesta ejemplo

{
  "data": [ { ... } ],
  "meta": {
    "page": 1,
    "limit": 50,
    "total": 8420
  }
}
GET/api/v1/domains

Lista los dominios activos de tu cuenta.

Respuesta ejemplo

{
  "data": [
    {
      "id": "dom_123",
      "hostname": "tutienda.com",
      "status": "ACTIVE",
      "createdAt": "2026-01-15T08:00:00Z"
    }
  ]
}
GET/api/v1/certificates/{consentId}

Descarga el certificado de auditoría firmado en PDF.

Parámetros

consentIdstringrequeridoID del consentimiento

Respuesta ejemplo

Content-Type: application/pdf
Content-Disposition: attachment; filename="cert_ck_abc123.pdf"

<binary PDF stream>
Ventas