---
title: "List employer plans"
method: GET
path: "/plans"
tags: ["Plans"]
---

# List employer plans

`GET /plans`

## Request

- Base URL: `https://api.cavuno.com/v1`
- URL: `https://api.cavuno.com/v1/plans`
- Auth: HTTP bearer

Returns the account's employer plans (the plans a board operator sells to employers), each with its single price and feature values.

## Response `200`

Successful response.

- object
  - `object` 'list', required
  - `url` string, required
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required
  - `data` AdminPlan[], required
    - `id` string, required: Unique identifier for the plan.
    - `object` 'plan', required
    - `name` string, required
    - `description` string, nullable, required
    - `kind` string, required
    - `billingInterval` 'day' | 'week' | 'month' | 'year', nullable, required: Subscription billing interval. Required for kind=subscription. Pair with billingIntervalCount for non-1 counts (quarterly = month × 3).
    - `billingIntervalCount` integer, nullable, required: Stripe recurring.interval_count. Null/omitted means 1. Quarterly is month × 3.
    - `purpose` 'job_posting' | 'talent_access' | 'membership' | 'job_seeker' | 'employer_service' | 'job_seeker_service', required: What the plan entitles: job-posting, talent-access, membership (employer membership), job-seeker (candidate paywall), or contact-led employer_service / job_seeker_service catalogue rows.
    - `isPublic` boolean, required
    - `isRecommended` boolean, required
    - `isArchived` boolean, required
    - `displayOrder` number, nullable, required
    - `pricingMode` 'priced' | 'contact', required: How the plan is sold. Plans created before this field existed report `priced`.
    - `priceText` string, nullable, required: Operator-authored display price text for a contact plan, e.g. "From $2,000". Null when unset.
    - `ctaText` string, nullable, required: Operator-authored CTA label for a contact plan.
    - `ctaDestination` string, nullable, required: The CTA target: an https, mailto:, or tel: URL. Null when unset, in which case no CTA is rendered.
    - `price` PlanPrice, nullable, required: The plan single active price, or null when no price has been set.
      - `currency` string, required: ISO 4217 currency code, lowercase.
      - `amountCents` integer, required: Unit amount in the smallest currency unit.
    - `features` PlanFeature[], required
      - `key` 'jobs.max_active' | 'jobs.included_posts' | 'jobs.duration_days' | 'jobs.featured_slots' | 'jobs.included_featured' | 'jobs.feature_selection_mode' | 'jobs.posting_discount_percent' | 'talent.profile_unlocks' | 'talent.messages_sent', required: Stable Cavuno plan capability key.
      - `name` string, nullable, required
      - `value` string, nullable, required

## Other responses

- `default`: An error. Every non-2xx response uses the same envelope; see the Errors section of the introduction.

## Changes

- **2026-10-19** `c34152c38176`: 1 info
  - added the optional property `error/upgrade` to the response with the `default` status

[Operation history](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/changes/plans/get.md)

---

[API](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api.md) · [All operations](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/revisions/d5974dabff14?raw)