> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockgence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticación

> Base URL, cómo mandar tu clave y qué ve cada clave.

## Base URL

```
https://app.blockgence.com/v1
```

Todas las rutas de la API cuelgan de `/v1`. Si tu organización tiene una instalación propia, usá la URL que te dieron.

## Mandar la clave

Toda ruta de `/v1` pide una clave de API. Va en cualquiera de estos dos headers:

**Authorization** `string`

`Bearer bkg_live_…`. La forma estándar, la que usan la mayoría de los clientes HTTP y el MCP.

**X-API-Key** `string`

`bkg_live_…`, sin prefijo. Equivalente al anterior.

```bash curl theme={null}
curl "https://app.blockgence.com/v1/screening/0x098b716b8aaf21512996dc57eb0615e2383e2f96?chain=ethereum" \
  -H "Authorization: Bearer $BKG_KEY"
```

```python Python theme={null}
import os
import httpx

r = httpx.get(
    "https://app.blockgence.com/v1/screening/0x098b716b8aaf21512996dc57eb0615e2383e2f96",
    params={"chain": "ethereum"},
    headers={"Authorization": f"Bearer {os.environ['BKG_KEY']}"},
)
r.raise_for_status()
print(r.json())
```

```javascript JavaScript theme={null}
const r = await fetch(
  "https://app.blockgence.com/v1/screening/0x098b716b8aaf21512996dc57eb0615e2383e2f96?chain=ethereum",
  { headers: { Authorization: `Bearer ${process.env.BKG_KEY}` } },
);
if (!r.ok) throw new Error(`${r.status}: ${(await r.json()).detail}`);
console.log(await r.json());
```

> [!WARNING]
>
> Guardá la clave en una variable de entorno o en un gestor de secretos, nunca en el código. Cómo crearla y revocarla:
> [Claves de API](https://docs.blockgence.com/es/get-started/api-keys.md).

## Qué ve cada clave

| Clave | Actúa como | Ve | Consume |
| - | - | - | - |
| Personal | Su dueño | Los casos y labels de esa persona, los mismos que en la web | El cupo de la persona o, en `enterprise`, el de su organización |
| De la organización | La organización | Los casos de la organización y los que ella comparte | El cupo de la organización |

Una clave de una persona con rol `viewer`, o una clave de la organización marcada `read_only`, solo lee: consulta todo
`GET` y los `POST` que no guardan nada. Ver [Cuentas y organizaciones](https://docs.blockgence.com/es/get-started/accounts-and-organizations.md#roles).

## Headers opcionales

**X-Case-Id** `string`

El caso en el que estás trabajando (`case_…`). Las consultas que lo llevan quedan en la cadena de custodia del caso y
las labels que cargues valen solo dentro de él. Si nombra un caso que no ves, la respuesta es `400` con
`error: "case_unavailable"` y la consulta no se hace.

## Respuestas de autenticación

| Status | Cuándo |
| - | - |
| `401` | Falta la clave, no existe, se revocó o la cuenta (o la organización) está desactivada. |
| `403` | La clave no puede hacer eso: es de solo lectura (`error: "read_only"`) o no tiene ese recurso entre sus `scopes` (`error: "key_scope"`). |
| `402` | Se agotó el cupo mensual. Ver [Créditos y límites](https://docs.blockgence.com/es/get-started/credits-and-limits.md). |
| `429` | Superaste el rate limit. Esperá lo que dice `Retry-After`. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.