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

# Use the API with an agent

> Have your agent call the Waterfall API directly over raw HTTP — auth, request shapes, pagination, and errors.

`waterfall-direct-api` teaches your agent to call the Waterfall API directly over raw HTTP, in whatever language or tool is already at hand. It carries auth, request/response shapes, pagination, and error handling.

## When to reach for it

Use it when you want to **use the API now**:

* An ad hoc lookup or one-off enrichment
* A quick script or notebook
* Exploring the data before you commit to anything
* An agent making live calls as part of a task

Nothing is written into your codebase, so there's nothing to maintain afterward.

## Install

```bash theme={null}
npx skills add waterfall/api-skills --skill waterfall-direct-api
```

Then point your agent at the repo and have it **fetch that link** so it works from the current skill definition:

**[https://github.com/Waterfall-io/api-skills](https://github.com/Waterfall-io/api-skills)**

## Source of truth

The skill tracks this documentation and the public OpenAPI spec. If its guidance ever conflicts with the live docs, the docs win.

Ready to build something durable instead? See [Integration](/v1/skills-integration).