# Almanac API V1 API

**Canonical:** https://apis.io/apis/almanac-ar/almanac-api-v1-api/  
**Provider:** Almanac — https://apis.io/providers/almanac-ar/  
**Base URL:** https://api.almanac.ar  
**Documentation:** https://api.almanac.ar/v1/openapi.json

Almanac API V1 API is one of 2 APIs that [Almanac](https://apis.io/providers/almanac-ar/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

API comercial de Almanac — Informe por CUIT (Reports/Account) + Datasets (catálogo público y descarga de snapshots). Autenticación por API key (`Authorization: Bearer alm_`, generada en https://almanac.ar/account) salvo donde se indica 'Público, sin auth'. La API le habla al cliente de INFORMES y AC

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/reports` | Generar o actualizar un Informe por CUIT |
| GET | `/v1/reports` | Listar los informes de la cuenta |
| GET | `/v1/reports/{id}` | Obtener un informe por id |
| GET | `/v1/reports/quote` | Presupuesto previo (lectura pura, no gasta saldo) |
| GET | `/v1/balance` | Saldo de la cuenta (cupo del plan + comprado) |
| GET | `/v1/prices` | Catálogo de precios de planes y packs |
| GET | `/v1/datasets` | Listar el catálogo de datasets publicados |
| GET | `/v1/datasets/{id}` | Ficha completa de un dataset (AI metadata) |
| GET | `/v1/datasets/{id}/snapshot` | URL firmada al snapshot vigente (Parquet/CSV) |
| GET | `/v1/openapi.json` | Este contrato OpenAPI 3.0, en JSON |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/almanac-ar/openapi/_original/almanac-ar-v1-openapi.json
- **JSONSchema** — https://artifacts.apis.io/almanac-ar/json-schema/almanac-ar-dataset-detail-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/almanac-ar/json-schema/almanac-ar-report-quote-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/almanac-ar/json-schema/almanac-ar-balance-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/almanac-ar/json-schema/almanac-ar-report-post-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/almanac-ar/json-schema/almanac-ar-report-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/almanac-ar/json-schema/almanac-ar-snapshot-response-schema.json

## Other Almanac APIs (1)

- [Almanac API](https://apis.io/apis/almanac-ar/almanac-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/almanac-ar/almanac-api-v1-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/almanac-ar/.