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

# Autenticación

> Cómo autenticar tus requests con Ipsofactura.

## Base URL

```
https://api.ipsofactura.com
```

¿Solo quieres probar? Usa el [sandbox](/sandbox) —gratis y sin validez fiscal— en
`https://sandbox.api.ipsofactura.com` con una API key de sandbox.

## API Keys

Ipsofactura autentica con una API key enviada en el header `x-api`. Todas las requests deben incluirlo.

```http theme={null}
x-api: {tu_api_key}
```

<Warning>
  Nunca expongas tu API key en código cliente (frontend, apps móviles). Haz las llamadas siempre desde tu backend.
</Warning>

## Errores de autenticación

Sin API key la respuesta es `401`:

```json theme={null}
{
  "code": "AUTHENTICATION_REQUIRED",
  "message": "Se requiere autenticación para acceder a este recurso"
}
```

Con una API key inválida, revocada o del ambiente equivocado, también `401`:

```json theme={null}
{
  "code": "INVALID_API_KEY",
  "message": "API key inválida o expirada. Verifica tu token de autenticación"
}
```

Si la cuenta está suspendida, `403`:

```json theme={null}
{
  "code": "ACCOUNT_SUSPENDED",
  "message": "La cuenta está suspendida. Contacta a soporte"
}
```

El catálogo completo de códigos está en [Errores](/errores).