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

# API de FinUp

> Conectá sistemas externos a un negocio de FinUp con una API key.

# API de FinUp

La API de FinUp permite que sistemas externos —un ERP, un CRM, una planilla o un
script— operen sobre **tu negocio**: clientes, créditos, cuotas, pagos,
sucursales, configuraciones, reportes y auditoría.

* **Base URL:** `https://api.finup.ar`
* **Formato:** JSON (`application/json`)
* **Autenticación:** API key del negocio (ver [Authentication](/api/authentication))

## Alcance de la clave

Cada clave tiene uno de dos alcances:

| Alcance | Puede |
| - | - |
| **Solo lectura** (`read`) | Métodos seguros: `GET` (y `HEAD`/`OPTIONS`). |
| **Acceso total** (`full`) | Lectura y escritura: `POST`, `PUT`, `PATCH`, `DELETE`. |

El alcance se aplica en el servidor: una clave de solo lectura que intente un
`POST` recibe `403`.

## Empezá

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/api/quickstart">
    Creá una clave y hacé tu primera llamada.
  </Card>

  <Card title="Autenticación" icon="shield-keyhole" href="/api/authentication">
    Headers, alcances y buenas prácticas de seguridad.
  </Card>

  <Card title="Convenciones y errores" icon="list" href="/api/conventions">
    Formato de datos, paginación y códigos de error.
  </Card>

  <Card title="Referencia" icon="code" href="/api-reference">
    Todos los endpoints, generados desde el OpenAPI.
  </Card>
</CardGroup>

<Note>
  La API opera **siempre dentro de un negocio**: la clave determina el negocio y
  todas las consultas quedan acotadas a él. No hay endpoints para administrar
  otros negocios (eso vive en la consola de superadmin, con sesión) ni se pueden
  **administrar claves** (`/api/api-keys`) con una API key: la gestión requiere
  sesión de **administrador**.
</Note>