# Readwise API

**Canonical:** https://apis.io/apis/readwise/readwise-api/  
**Provider:** Readwise — https://apis.io/providers/readwise/  
**Documentation:** https://readwise.io/reader_api

Readwise API is one of 2 APIs that [Readwise](https://apis.io/providers/readwise/) 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.

Readwise API as documented publicly: 14 operations. Contract generated from the documentation by API Evangelist (2026-10-28); not the provider's own document.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v2/highlights` | POST /api/v2/highlights |
| GET | `/api/v2/highlights/` | Returns a list of highlights with pagination metadata, supporting filtering and querying options. |
| GET | `/api/v2/review` | GET /api/v2/review |
| POST | `/api/v2/review/complete` | POST /api/v2/review/complete |
| PATCH | `/api/v3/bulk_update` | PATCH /api/v3/bulk_update |
| PATCH | `/api/v3/bulk_update/` | Update multiple documents in a single request. |
| DELETE | `/api/v3/delete/0000ffff2222eeee3333dddd4444` | DELETE /api/v3/delete/0000ffff2222eeee3333dddd4444 |
| GET | `/api/v3/list` | GET /api/v3/list |
| GET | `/api/v3/list/` | Fetch your documents. |
| POST | `/api/v3/save` | POST /api/v3/save |
| POST | `/api/v3/save/` | Save new documents to Reader and create highlights. |
| GET | `/api/v3/tags` | GET /api/v3/tags |
| GET | `/api/v3/tags/` | Retrieve all tags available. |
| PATCH | `/api/v3/update/0000ffff2222eeee3333dddd4444` | PATCH /api/v3/update/0000ffff2222eeee3333dddd4444 |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/readwise/openapi/_ae-authored/readwise-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/readwise/json-schema/readwise-post-api-v3-save-request2-schema.json
- **JSONSchema** — https://artifacts.apis.io/readwise/json-schema/readwise-post-api-v2-highlights-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/readwise/json-schema/readwise-post-api-v2-review-complete-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/readwise/json-schema/readwise-get-api-v3-list-response2-schema.json
- **JSONSchema** — https://artifacts.apis.io/readwise/json-schema/readwise-get-api-v3-tags-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/readwise/json-schema/readwise-delete-api-v3-delete0000-ffff2222-eeee3333-dddd4444-response-schema.json

## Other Readwise APIs (1)

- [Readwise API](https://apis.io/apis/readwise/readwise-api-2/)

---

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