# Appendix api reference API

**Canonical:** https://apis.io/apis/appendix-com/api-reference-api/  
**Provider:** Appendix — https://apis.io/providers/appendix-com/  
**Base URL:** https://api.appendix.com  
**Documentation:** https://appendix.com/docs/api-reference

Appendix api reference API is one of 3 APIs that [Appendix](https://apis.io/providers/appendix-com/) 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.

Appendix api reference API as documented publicly: 24 operations. Contract generated from the documentation by API Evangelist (2026-11-01); not the provider's own document.

## Operations (24)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/agent/encounters/{encounterId}/events` | Poll for messages |
| POST | `/api/v1/agent/encounters/{encounterId}/events` | Reply on the patient's behalf |
| POST | `/api/v1/agent/encounters/{encounterId}/events/read` | Mark messages read |
| POST | `/api/v1/agent/query` | Send one of the following in the Authorization header. |
| GET | `/api/v1/config/conditions` | Conditions list |
| GET | `/api/v1/config/pricing` | Pricing |
| GET | `/api/v1/encounters` | List your encounters |
| GET | `/api/v1/encounters/{id}` | Get encounter |
| POST | `/api/v1/encounters/{id}/cancel` | Cancel encounter |
| GET | `/api/v1/encounters/{id}/latest-turn` | Latest turn |
| GET | `/api/v1/encounters/{id}/turns` | List turns |
| GET | `/api/v1/knowledge/search` | Knowledge base search |
| GET | `/api/v1/patients` | Retrieve patient identifiers for binding encounters. |
| POST | `/api/v1/patients` | Add a person |
| DELETE | `/api/v1/patients/{id}` | Remove patient |
| GET | `/api/v1/patients/{id}` | Get patient |
| PATCH | `/api/v1/patients/{id}` | Update patient |
| GET | `/api/v1/subscriptions/me` | Current subscription |
| GET | `/api/v1/subscriptions/me/invoices` | Recent invoices |
| GET | `/api/v1/subscriptions/me/payment-method` | Default payment method |
| GET | `/api/v1/users/me` | Current user |
| GET | `/api/v1/users/me/api-keys` | List API keys |
| POST | `/api/v1/users/me/api-keys` | Create API key |
| GET | `/api/v1/users/me/submissions` | List submissions |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/appendix-com/openapi/_ae-authored/appendix-com-api-reference-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/appendix-com/json-schema/appendix-com-post-api-v1-users-me-api-keys-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/appendix-com/json-schema/appendix-com-get-api-v1-users-me-api-keys-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/appendix-com/json-schema/appendix-com-get-api-v1-users-me-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/appendix-com/json-schema/appendix-com-post-api-v1-users-me-api-keys-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/appendix-com/json-schema/appendix-com-get-api-v1-agent-encounters-encounterid-events-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/appendix-com/json-schema/appendix-com-get-api-v1-patients-response-schema.json
- **APIsJSON** — https://artifacts.apis.io/appendix-com/apis.yml

## Other Appendix APIs (2)

- [Appendix core API](https://apis.io/apis/appendix-com/core-api/)
- [Appendix Prescribing API Overview API](https://apis.io/apis/appendix-com/prescribing-api/)

---

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