Skip to main content
POST
Create a service

Authorizations

Authorization
string
header
required

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

Body

application/json
clinic_location_group_ids
integer[]
required

If defined, the subset of clinic location groups that this service is for.Otherwise, the service is for all clinics in the group regardless of their location group.

code
string
required

The unique service code for this service.

display_name
string
required

The display name of the service. Defaults to the service's name if not defined.

has_fixed_subtotal
boolean
required

Whether this service should be priced as a fixed subtotal.

invoiced_as_non_integer
boolean
required

Whether this service is invoiced in integer increments or not.

is_enabled
boolean
required

Whether the service is enabled.

kind
required

The type of the service.

Available options:
PROCEDURE,
PRODUCT,
MEDICATION,
VACCINE,
LAB,
FEE,
SERVICE,
UNKNOWN,
CARE_PLAN
min_price
integer | null
required

The minimum price for this service, below which it cannot be discounted.

Required range: x >= 0
name
string
required

The name of this service.

service_pricing_category_id
integer
required

The ID of the pricing category for this service.

tax_category_id
integer
required

The ID of the tax category for this service.

unit_of_measure
required

The unit of measurement. This service is sold in increments of this unit.

Available options:
APPLICATOR,
BAG,
BOTTLE,
BOX,
BUCKET,
CAN,
CAPLET,
CAPSULE,
CASE,
CATHETER,
CHEW,
COLLAR,
DOSE,
EACH,
GRAM,
GALLON,
JAR,
KIT,
POUND,
LITER,
MILLILITER,
NEEDLE,
OUNCE,
PACKET,
PAIR,
PIPETTE,
PURCHASING_UNIT,
QUART,
ROLL,
SUTURE,
SYRINGE,
TABLET,
TEST,
TRAY,
TUB,
TUBE,
VIAL,
YARD
breeds
string[]

A list of breed names associated with this service. If the given value is an empty list ([]), that indicates that breed is not a relevant criteria for this service and should be ignored.

default_duration_scales_with_quantity
boolean | null

Whether this service's default duration scales with quantity.

default_duration_unit
enum<string> | null

The unit of default duration used for this service. Only applicable when the kind is PROCEDURE, PRODUCT, MEDICATION, LAB, or SERVICE.

Available options:
DAY,
WEEK,
MONTH,
YEAR
default_duration_value
integer | null

The value of the default duration used for this service. Only applicable when the kind is PROCEDURE, PRODUCT, MEDICATION, LAB, or SERVICE.

Required range: x >= 1
default_durations
ExternalServiceVaccineDefaultDurationCreateOrUpdateSchema · object[] | null

Per-reminder default durations for active standard care reminders linked to this vaccine service. Only applicable when the kind is VACCINE.

default_location
enum<string> | null

The default location that this vaccine/medication will be administered at. Only applicable when the kind of the associated group service is VACCINE or MEDICATION.

Available options:
RIGHT_SHOULDER,
RIGHT_REAR,
LEFT_SHOULDER,
LEFT_REAR,
RIGHT_CEPHALIC,
LEFT_CEPHALIC,
RIGHT_SAPHENOUS,
LEFT_SAPHENOUS,
RIGHT_EPAXIAL,
LEFT_EPAXIAL,
JUGULAR,
ORAL,
INTRANASAL,
INTERSCAPULAR,
LEFT_EYE,
RIGHT_EYE,
BOTH_EYES,
EYELIDS,
LEFT_EAR,
RIGHT_EAR,
BOTH_EARS,
EARS,
OTHER,
BACK_OF_NECK,
MOUTH,
INTERDIGITAL,
PAWS,
TESTICLES,
LOWER_RIGHT_QUADRANT,
LOWER_LEFT_QUADRANT,
INTRACARDIAC,
PROXIMAL_TIBIA,
PROXIMAL_FEMUR,
PROXIMAL_HUMERUS,
EPAXIAL,
INTRASCAPULAR
default_price
integer | null

The default price for this service if not overridden elsewhere.

Required range: x >= 0
default_route
enum<string> | null

The default route that this vaccine/medication will be administered through. Only applicable when the kind of the associated group service is VACCINE or MEDICATION.

Available options:
INTRACARDIAC,
INTRAMUSCULAR,
INTRANASAL,
INTRAPERITONEAL,
INTRAOSSEOUS,
INTRATESTICULAR,
INTRAVENOUS,
OCULAR,
ORAL,
ORAL_NERVE_BLOCK,
OTIC,
SUBCUTANEOUS,
TOPICAL
default_sig
string | null

The default signature for this service. Only applicable when the kind of the associated group service is MEDICATION.

default_treatment_kind
enum<string> | null

The default kind of treatment this service represents. Only applicable when the kind of the associated group service is PRODUCT or MEDICATION.

Available options:
IN_CLINIC,
TAKE_HOME
din
string | null

The Drug Identification Number (DIN) for this service. Only applicable when the kind of the associated group service is MEDICATION or PRODUCT and the clinic is in Canada.

exclude_from_discounts
boolean | null

Whether this service is excluded from discounts.

has_in_clinic_dispense_fee
boolean | null
default:false

Whether this service has a dispense fee when administered in-clinic.

has_lot_number_for_treatments
boolean | null

Whether the lot number field is shown in the treatment form. Only applicable when the kind of the associated group service is PRODUCT, MEDICATION, or SERVICE.

has_route_and_location_for_treatments
boolean | null

Whether the route/location fields are shown in treatment forms for the service. Only applicable when the kind of the associated group service is MEDICATION.

has_sig_for_treatments
boolean | null

Whether this product should have a signature input in treatments. Only applicable when the kind of the associated group service is PRODUCT.

has_take_home_dispense_fee
boolean | null
default:false

Whether this service has a dispense fee when taken home by the pet parent.

is_altered
boolean | null

Whether a patient eligible for this service has been spayed/neutered.

is_invoice_only
boolean | null

Whether this service is only invoiced, not charged for hospitalizations.

is_removable
boolean
default:false

Whether this service is removable once added to the medical record. Only relevant for linked services.

is_searchable_for_line_items
boolean
default:true

Whether this service is searchable in medical records, invoices, and estimates, to be added as a line item.

keywords
string[] | null

A list of keywords associated with this service.

max_age
integer | null

The maximum age of a patient eligible for this service, in the unit specified by max_age_units.

Required range: x >= 0
max_age_units
default:""

The unit in which the max_age is defined.

Available options:
DAY,
WEEK,
MONTH,
YEAR
max_quantity

The maximum quantity that can be invoiced for this service.

Required range: x >= 0
max_uses_per_charge
integer | null

The maximum number of uses per charge for this service.

max_weight
number | null

The maximum weight of a patient eligible for this service, in pounds.

Required range: x >= 0
min_age
integer | null

The minimum age of a patient eligible for this service, in the unit specified by min_age_units.

Required range: x >= 0
min_age_units
default:""

The unit in which the min_age is defined.

Available options:
DAY,
WEEK,
MONTH,
YEAR
min_weight
number | null

The minimum weight of a patient eligible for this service, in pounds.

Required range: x >= 0
minimum_subtotal
integer | null

The minimum subtotal in cents for this service.

Required range: x >= 0
procedure_kind
enum<string> | null

The kind of procedure this service represents. Only applicable when the kind of the associated group service is PROCEDURE.

Available options:
EUTHANASIA,
SPAY,
NEUTER,
OTHER
revenue_category_id
integer | null

The ID of the revenue category for this service.

sex
default:""

The sex of a patient eligible for this service.

Available options:
MALE,
FEMALE,
UNKNOWN
species
enum<string>[]

The species of patient associated with this service. If the given value is an empty list ([]), that indicates that species is not a relevant criteria for this service and should be ignored.

Available options:
CANINE,
FELINE,
EQUINE,
AVIAN,
BOVINE,
FERRET,
RABBIT,
RODENT,
REPTILE,
AMPHIBIAN,
FISH,
PORCINE,
CAPRINE,
SHEEP,
CAMELID,
RATITE,
MARSUPIAL,
MUSTELID,
CERVID,
PROCYONIDAE,
ERINACEIDAE,
MEPHITIDAE,
OTHER,
UNSPECIFIED
treatment_sheet_billing_type
enum<string> | null

The treatment sheet billing type for this service.

Available options:
FIXED_RATE,
MAX_USES_PER_CHARGE,
NON_CHARGEABLE
treatment_sheet_category
enum<string> | null

The treatment sheet category of this service.

Available options:
BUNDLE,
VITAL,
TASK,
NUTRITION,
FLUID,
PATIENT_CARE,
PROCEDURE,
PRODUCT,
MEDICATION,
VACCINE,
LAB,
SERVICE
vaccine_kind
enum<string> | null

The kind of vaccine this service represents. Only applicable when the kind of the associated group service is VACCINE.

Available options:
RABIES,
OTHER

Response

201 - application/json

Created

code
string
required

The unique service code for this service.

created_at
string<date-time>
required

The date and time the service was created.

has_fixed_subtotal
boolean
required

Whether this service should be priced as a fixed subtotal.

id
integer
required

The unique identifier for the service.

is_enabled
boolean
required

Whether the service is enabled.

is_removable
boolean
required

Whether this service is removable once added to the medical record. Only relevant for linked services.

is_searchable_for_line_items
boolean
required

Whether this service is searchable in medical records, invoices, and estimates, to be added as a line item.

kind
required

The type of the service.

Available options:
PROCEDURE,
PRODUCT,
MEDICATION,
VACCINE,
LAB,
FEE,
SERVICE,
UNKNOWN,
CARE_PLAN
min_price
integer | null
required

The minimum price for this service, below which it cannot be discounted.

Required range: x >= 0
name
string
required

The name of this service.

revenue_category_id
integer | null
required

The ID of the revenue category for this service.

service_pricing_category_id
integer
required

The ID of the pricing category for this service.

tax_category_id
integer
required

The ID of the tax category for this service.

unit_of_measure
required

The unit of measurement. This service is sold in increments of this unit.

Available options:
APPLICATOR,
BAG,
BOTTLE,
BOX,
BUCKET,
CAN,
CAPLET,
CAPSULE,
CASE,
CATHETER,
CHEW,
COLLAR,
DOSE,
EACH,
GRAM,
GALLON,
JAR,
KIT,
POUND,
LITER,
MILLILITER,
NEEDLE,
OUNCE,
PACKET,
PAIR,
PIPETTE,
PURCHASING_UNIT,
QUART,
ROLL,
SUTURE,
SYRINGE,
TABLET,
TEST,
TRAY,
TUB,
TUBE,
VIAL,
YARD
breeds
string[] | null

A list of breed names associated with this service. If the given value is an empty list ([]), that indicates that breed is not a relevant criteria for this service and should be ignored.

clinic_location_group_ids
integer[]

If defined, the subset of clinic location groups that this service is for.Otherwise, the service is for all clinics in the group regardless of their location group.

default_duration_scales_with_quantity
boolean | null

Whether this service's default duration scales with quantity.

default_duration_unit
enum<string> | null

The unit of default duration used for this service. Only applicable when the kind is PROCEDURE, PRODUCT, MEDICATION, LAB, or SERVICE.

Available options:
DAY,
WEEK,
MONTH,
YEAR
default_duration_value
integer | null

The value of the default duration used for this service. Only applicable when the kind is PROCEDURE, PRODUCT, MEDICATION, LAB, or SERVICE.

Required range: x >= 1
default_durations
ExternalServiceVaccineDefaultDurationSchema · object[] | null

Per-reminder default durations for active standard care reminders linked to this vaccine service. Only applicable when the kind is VACCINE.

default_location
enum<string> | null

The default location that this vaccine/medication will be administered at. Only applicable when the kind of the associated group service is VACCINE or MEDICATION.

Available options:
RIGHT_SHOULDER,
RIGHT_REAR,
LEFT_SHOULDER,
LEFT_REAR,
RIGHT_CEPHALIC,
LEFT_CEPHALIC,
RIGHT_SAPHENOUS,
LEFT_SAPHENOUS,
RIGHT_EPAXIAL,
LEFT_EPAXIAL,
JUGULAR,
ORAL,
INTRANASAL,
INTERSCAPULAR,
LEFT_EYE,
RIGHT_EYE,
BOTH_EYES,
EYELIDS,
LEFT_EAR,
RIGHT_EAR,
BOTH_EARS,
EARS,
OTHER,
BACK_OF_NECK,
MOUTH,
INTERDIGITAL,
PAWS,
TESTICLES,
LOWER_RIGHT_QUADRANT,
LOWER_LEFT_QUADRANT,
INTRACARDIAC,
PROXIMAL_TIBIA,
PROXIMAL_FEMUR,
PROXIMAL_HUMERUS,
EPAXIAL,
INTRASCAPULAR
default_price
integer | null

The default price for this service if not overridden elsewhere.

Required range: x >= 0
default_route
enum<string> | null

The default route that this vaccine/medication will be administered through. Only applicable when the kind of the associated group service is VACCINE or MEDICATION.

Available options:
INTRACARDIAC,
INTRAMUSCULAR,
INTRANASAL,
INTRAPERITONEAL,
INTRAOSSEOUS,
INTRATESTICULAR,
INTRAVENOUS,
OCULAR,
ORAL,
ORAL_NERVE_BLOCK,
OTIC,
SUBCUTANEOUS,
TOPICAL
default_sig
string | null

The default signature for this service. Only applicable when the kind of the associated group service is MEDICATION.

default_treatment_kind
enum<string> | null

The default kind of treatment this service represents. Only applicable when the kind of the associated group service is PRODUCT or MEDICATION.

Available options:
IN_CLINIC,
TAKE_HOME
din
string | null

The Drug Identification Number (DIN) for this service. Only applicable when the kind of the associated group service is MEDICATION or PRODUCT and the clinic is in Canada.

display_name
string | null

The display name of the service. Defaults to the service's name if not defined.

exclude_from_discounts
boolean | null

Whether this service is excluded from discounts.

has_in_clinic_dispense_fee
boolean | null
default:false

Whether this service has a dispense fee when administered in-clinic.

has_lot_number_for_treatments
boolean | null

Whether the lot number field is shown in the treatment form. Only applicable when the kind of the associated group service is PRODUCT, MEDICATION, or SERVICE.

has_route_and_location_for_treatments
boolean | null

Whether the route/location fields are shown in treatment forms for the service. Only applicable when the kind of the associated group service is MEDICATION.

has_sig_for_treatments
boolean | null

Whether this product should have a signature input in treatments. Only applicable when the kind of the associated group service is PRODUCT.

has_take_home_dispense_fee
boolean | null
default:false

Whether this service has a dispense fee when taken home by the pet parent.

invoiced_as_non_integer
boolean | null

Whether this service is invoiced in integer increments or not.

is_altered
boolean | null

Whether a patient eligible for this service has been spayed/neutered.

is_invoice_only
boolean | null

Whether this service is only invoiced, not charged for hospitalizations.

keywords
string[] | null

A list of keywords associated with this service.

max_age
integer | null

The maximum age of a patient eligible for this service, in the unit specified by max_age_units.

Required range: x >= 0
max_age_units

The unit in which the max_age is defined.

Available options:
DAY,
WEEK,
MONTH,
YEAR
max_quantity

The maximum quantity that can be invoiced for this service.

Required range: x >= 0
max_uses_per_charge
integer | null

The maximum number of uses per charge for this service.

max_weight
number | null

The maximum weight of a patient eligible for this service, in pounds.

Required range: x >= 0
min_age
integer | null

The minimum age of a patient eligible for this service, in the unit specified by min_age_units.

Required range: x >= 0
min_age_units

The unit in which the min_age is defined.

Available options:
DAY,
WEEK,
MONTH,
YEAR
min_weight
number | null

The minimum weight of a patient eligible for this service, in pounds.

Required range: x >= 0
minimum_subtotal
integer | null

The minimum subtotal in cents for this service.

Required range: x >= 0
procedure_kind
enum<string> | null

The kind of procedure this service represents. Only applicable when the kind of the associated group service is PROCEDURE.

Available options:
EUTHANASIA,
SPAY,
NEUTER,
OTHER
sex

The sex of a patient eligible for this service.

Available options:
MALE,
FEMALE,
UNKNOWN
species
(enum<string> | string)[] | null

The species of patient associated with this service. If the given value is an empty list ([]), that indicates that species is not a relevant criteria for this service and should be ignored.

Available options:
CANINE,
FELINE,
EQUINE,
AVIAN,
BOVINE,
FERRET,
RABBIT,
RODENT,
REPTILE,
AMPHIBIAN,
FISH,
PORCINE,
CAPRINE,
SHEEP,
CAMELID,
RATITE,
MARSUPIAL,
MUSTELID,
CERVID,
PROCYONIDAE,
ERINACEIDAE,
MEPHITIDAE,
OTHER,
UNSPECIFIED
treatment_sheet_billing_type
enum<string> | null

The treatment sheet billing type for this service.

Available options:
FIXED_RATE,
MAX_USES_PER_CHARGE,
NON_CHARGEABLE
treatment_sheet_category
enum<string> | null

The treatment sheet category for this service, used for grouping in treatment sheet workflows.

Available options:
BUNDLE,
VITAL,
TASK,
NUTRITION,
FLUID,
PATIENT_CARE,
PROCEDURE,
PRODUCT,
MEDICATION,
VACCINE,
LAB,
SERVICE
vaccine_kind
enum<string> | null

The kind of vaccine this service represents. Only applicable when the kind of the associated group service is VACCINE.

Available options:
RABIES,
OTHER