---
title: "Get a list of reminder protocol usage for a pet"
method: GET
path: "/api/v1/reminder-protocol-usages"
tags: ["Reminder Protocol Usages"]
---

# Get a list of reminder protocol usage for a pet

`GET /api/v1/reminder-protocol-usages`

Returns list of all of the reminder protocol usage for a pet. This information can be found in the UI on the pet's profile page under the "Preventive" tab.

## Query parameters

- `filter[reminder_protocol_template_id]` integer
- `filter[reminder_protocol_template_ids]` string
- `filter[latest]` boolean
- `filter[due_date_type]` 'due' | 'overdue' | 'upcoming'
- `filter[active]` boolean
- `filter[exclude_historical]` boolean
- `filter[date_before]` string
- `filter[last_fetched]` string

## Parameters

- `#/paths/~1api~1v1~1pets/get/parameters/0` — unresolved $ref
- `#/paths/~1api~1v1~1files/get/parameters/0` — unresolved $ref

## Response `200`

Successful operation

- object
  - `data` object[]
    - `id` integer
    - `clinic_id` integer
    - `reminder_protocol_template_id` integer
    - `record_id` integer
    - `pet_id` integer
    - `vet_id` integer
    - `treatment_type_id` integer
    - `due_date` string, date — This date is in the clinic's timezone, this will be deprecated in the future so please use the due_date_utc field
    - `administration_date` string, date — This date is in the clinic's timezone, this will be deprecated in the future so please use the administration_date_utc field
    - `clinic` Data — unresolved $ref
    - `due_date_utc` string, date
    - `administration_date_utc` string, date
    - `overwritten_by` integer
    - `is_active` boolean
    - `pet` object — General information about the pet.
      - `id` integer
      - `nickname` string
      - `species` object
        - `id` integer
        - `label` string
      - `breed` object
        - `id` integer
        - `label` string
        - `species_id` integer
      - `birthday` string
      - `gender` 'male' | 'female' | 'unknown'
      - `hormonal_status` 0 | 1 | 2
      - `profile_picture` string
    - `protocol_template` object
      - `id` integer
      - `name` string
      - `clinic_id` integer
      - `is_enabled` integer
      - `product_categories` object[]
        - `id` integer
        - `product_category_id` integer
        - `name` string
        - `products` object[]
          - `id` integer
          - `name` string
        - `created_at` string, date-time
      - `visit_types` object[]
        - `id` integer
        - `visit_type_id` integer
        - `name` string
        - `services` object[]
          - `id` integer
          - `name` string
        - `created_at` string, date-time
      - `template_overwrites` object[]
        - `id` integer
        - `name` string
      - `template_overwritten_by` object[]
        - `id` integer
        - `name` string
      - `intervals` object[]
        - `id` integer
        - `duration` integer
        - `unit` string
        - `time_to_in_days` integer
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `protocol_usage_items` object[]
      - `id` integer
      - `reminder_protocol_id` integer
      - `reminder_protocol_usage_itemable_id` integer
      - `reminder_protocol_usage_itemable_type` string
      - `reminder_protocol_usage_itemable` object
        - `name` string
        - `batch_number` string
        - `manufacturer` string
        - `rabic_tag_number` string
        - `expiration_date` string, date
        - `printed_files` object[]
          - `id` integer
          - `name` string
          - `title` string
          - `real_name` string
          - `printable_file_id` integer
          - `vet_id` integer
          - `patient_id` integer
          - `created_at` string, date-time
  - `links` Links — unresolved $ref
  - `meta` Meta — unresolved $ref

## Other responses

- `401` — unresolved $ref
- `403` — unresolved $ref
- `429` — unresolved $ref

---

[API](https://skmtc.net/digitail/apis/digitail-api.md) · [All operations](https://skmtc.net/digitail/apis/digitail-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitail/digitail-api/revisions/bd9694db5fce/schema)