Skip to main content
POST
Import or update a legacy patient care plan

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Schema for importing a legacy patient care plan via the external API.

amount_paid
integer
required

The amount paid for the care plan

Required range: x >= 0
care_benefits
ExternalLegacyPatientCareBenefitImportSchema · object[]
required

The care benefits to import for the care plan

care_plan_id
integer
required

The core Care Plan ID to enroll the patient into

clinic_id
integer
required

The clinic ID for the patient and client being imported

end_date
string<date>
required

End date for the care plan (YYYY-MM-DD). This is non-inclusive, meaning a plan ending on 2/1/2026 would not be considered active/usable on 2/1/2026.

enrollment_fee
integer
required

The enrollment fee of the care plan

Required range: x >= 0
is_billed_monthly
boolean
required

Whether billing is monthly (True) or upfront (False)

pim_client_id
string
required

The PIM client ID to import the care plan for

pim_patient_id
string
required

The PIM patient ID to import the care plan for

plan_cost
integer
required

The cost of the care plan

Required range: x >= 0
should_renew
boolean
required

Whether the plan should automatically renew at the end of term

start_date
string<date>
required

Start date for the enrollment (YYYY-MM-DD)

status
enum<string>
required

The status of the care plan. Must be one of: IMPORTED, ACTIVE, TERMINATED

Available options:
IMPORTED,
CLIENT_CREATED,
CLINIC_CREATED,
ACTIVE,
TERMINATED,
PAYMENT_FAILED,
SUSPENDED
clinic_client_id
integer | null

Optional Vetcove client ID. When provided, bypasses PIM ID lookup and resolves the client by primary key (scoped to clinic). Use this to disambiguate when multiple clients share the same pim_client_id.

clinic_patient_id
integer | null

Optional Vetcove patient ID. When provided, bypasses PIM ID lookup and resolves the patient by primary key (scoped to clinic). Use this to disambiguate when multiple patients share the same pim_patient_id.

next_plan_id
integer | null

Optional next core Care Plan ID for automatic renewal

payment_method_id
integer | null

Optional Vetcove payment method ID. When provided, takes precedence over stripe_payment_method_id and resolves the payment method by primary key (scoped to the client). Both payment method fields are optional for all statuses. Omitting both means the payment method must be updated later before billing.

stripe_payment_method_id
string | null

Optional legacy Stripe payment method ID to use for billing. payment_method_id takes precedence when both fields are provided. Both payment method fields are optional for all statuses. Omitting both means the payment method must be updated later before billing.

Response

OK

care_plan_id
integer
required

The ID of the Care Plan this patient-specific plan is linked to

care_plan_kind
enum<string>
required

The type of the care plan

Available options:
CORE,
ADD_ON,
SERVICE_PACKAGE
care_plan_name
string
required

The name of the care plan this patient care plan is linked to

clinic_client_id
integer
required

The ID of the clinic client this patient care plan is associated with

clinic_id
integer
required

The ID of the clinic this patient care plan is associated with

clinic_patient_id
integer
required

The ID of the clinic patient this care plan is associated with

core_plan_id
integer | null
required

The ID of the core patient care plan this one is linked to, if this is an add-on plan

deactivated_at
string<date-time> | null
required

When this care plan was deactivated, if applicable

deactivated_by
string | null
required

The name of the user who deactivated the care plan, if applicable

end_date
string<date>
required

End date for the care plan (YYYY-MM-DD). This is non-inclusive, meaning a plan ending on 2/1/2026 would not be considered active/usable on 2/1/2026.

enrollment_fee
integer
required

The enrollment fee of the care plan

Required range: x >= 0
id
integer
required

The unique identifier for the patient care plan

is_billed_monthly
boolean
required

Whether the care plan is billed monthly or upfront

monthly_cost
integer | null
required

The monthly cost of the care plan, in cents. Only applicable to monthly billed care plans.

Required range: x >= 0
next_payment_date
string<date> | null
required

The date of the next payment for the care plan, if applicable

next_plan_id
integer | null
required

The ID of the next care plan, if applicable

payment_method_id
integer | null
required

The ID of the payment method associated with this care plan

plan_cost
integer
required

The cost of the care plan

Required range: x >= 0
remaining_balance
integer
required

The remaining balance of the care plan, in cents

should_renew
boolean
required

Whether this care plan will automatically be renewed

start_date
string<date>
required

The start date of the care plan

status
required

The status of the patient care plan

Available options:
IMPORTED,
CLIENT_CREATED,
CLINIC_CREATED,
ACTIVE,
TERMINATED,
PAYMENT_FAILED,
SUSPENDED