---
search:
  tags:
    - Health Plans
    - GET
seo:
  description: >-
    Returns a paginated list of health plans for the expert. Page size is fixed
    at 50. Reference for the GET /health-plans endpoint in the Almendra API.
sidebar:
  label: List health plans
  badge: GET
title: List health plans
type: openapi-operation
---
Returns a paginated list of health plans for the expert. Page size is fixed at 50.

Requires the `health_plans:read` permission.

`GET /health-plans`

**Responses**

- `200` — List of health plans
- `400` — Invalid path parameter, query parameter or request body
- `401` — Unauthorized - Invalid API key
- `403` — The account behind the API key has no active paid plan, or the key lacks the permission this operation needs
- `404` — Expert not found
- `429` — Rate limit exceeded (600 requests per 60 seconds); retry after \`Retry-After\` seconds
- `500` — Unexpected server error

Response example, 200:

```json
{
  "healthPlans": [
    {
      "_id": "507f1f77bcf86cd799439013",
      "planName": "Basic Consultation",
      "planDescription": "Standard consultation package",
      "publicHealthPlan": true,
      "isSingleAppointment": true,
      "totalAppointments": 1,
      "includedAppointments": [
        1
      ],
      "price": 100,
      "currency": "USD",
      "createdAt": "2024-01-15T00:00:00.000Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "totalCount": 10,
  "totalPages": 1
}
```