> ## 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.

# Quickstart

> De cero a tu primera llamada autenticada a la API de FinUp.

# Quickstart

En 3 pasos tenés una integración funcionando.

<Steps>
  <Step title="Creá una API key">
    En FinUp, entrá a **API Keys → Nueva API key**, ponele un nombre, elegí el
    acceso (**Solo lectura** o **Acceso total**) y copiá la clave cuando se
    muestra. Ver [Claves API](/guia/api-keys).

    La clave tiene esta forma:

    ```text theme={null}
    finup_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    ```
  </Step>

  <Step title="Hacé tu primera llamada">
    Pedí la lista de clientes del negocio:

    <CodeGroup>
      ```bash cURL theme={null}
      curl --request GET \
        --url "https://api.finup.ar/api/clients" \
        --header "Authorization: Bearer $FINUP_API_KEY"
      ```

      ```javascript JavaScript theme={null}
      const res = await fetch("https://api.finup.ar/api/clients", {
        headers: { Authorization: `Bearer ${process.env.FINUP_API_KEY}` },
      });
      const data = await res.json();
      console.log(data.clients, data.nextCursor);
      ```

      ```python Python theme={null}
      import os, requests

      res = requests.get(
          "https://api.finup.ar/api/clients",
          headers={"Authorization": f"Bearer {os.environ['FINUP_API_KEY']}"},
          timeout=30,
      )
      res.raise_for_status()
      print(res.json()["clients"])
      ```
    </CodeGroup>

    Respuesta:

    ```json theme={null}
    {
      "clients": [
        {
          "id": "b1f2...",
          "first_name": "María",
          "last_name": "González",
          "dni": "30123456",
          "created_at": "2026-01-14T12:00:00.000Z"
        }
      ],
      "nextCursor": null
    }
    ```
  </Step>

  <Step title="Creá un crédito (acceso total)">
    Con una clave de **acceso total**, otorgá un crédito a un cliente usando un
    plan activo:

    ```bash theme={null}
    curl --request POST \
      --url "https://api.finup.ar/api/clients/$CLIENT_ID/credits" \
      --header "Authorization: Bearer $FINUP_API_KEY" \
      --header "Content-Type: application/json" \
      --data '{ "amount": 300000, "credit_config_id": "CONFIG_UUID" }'
    ```

    La respuesta incluye el crédito y sus cuotas:

    ```json theme={null}
    {
      "credit": { "id": "…", "amount": 300000, "status": "active", "sequential_id": 1042 },
      "installments": [
        { "number": 1, "amount": 58500, "due_date": "2026-02-10", "status": "pending" }
      ]
    }
    ```
  </Step>
</Steps>

<Warning>
  Una clave de **solo lectura** que intente un `POST` recibe
  `403 { "error": "This API key only allows read access" }`.
</Warning>

## Siguientes pasos

* [Flujo: clientes y créditos](/api/flujo-clientes-y-creditos)
* [Flujo: pagos](/api/flujo-pagos)
* [Convenciones y errores](/api/conventions)