# Gingr Parents API

**Canonical:** https://apis.io/apis/gingr/gingr-parents-api/  
**Provider:** Gingr — https://apis.io/providers/gingr/  
**Base URL:** https://api.gingr.io/v1  
**Documentation:** https://support.gingrapp.com/hc/en-us/articles/25722122517517-Gingr-API-Functions-Reference

Gingr Parents API is one of 12 APIs that [Gingr](https://apis.io/providers/gingr/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Parents. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

The **Parents** group covers everything related to the pet owner — referred to as a **Parent** in Gingr. A Parent is the primary account holder who owns one or more animals and makes bookings. Use this group to: - **Create** new parents during the intake flow (e.g., an online booking portal). - **Update** parent profile data such as contact info, address, and custom fields. - **Search / list** parents by name, email, phone, and other filters. - **Manage memberships** — enroll or cancel a parent's membership plan. - **Manage cards on file** — retrieve saved payment methods so you can pre-fill checkout forms. - **Handle agreements** — check which digital waivers a parent still needs to sign and mark them as signed. Important considerations: - `email` and `cellPhone` are unique per organization. Attempting to create a duplicate will return a `422` validation error. - `allowOnlineLogin` controls whether the parent can log in to the Gingr consumer portal. This defaults to `false` for API-created parents unless explicitly set. - Custom fields (configured per organization) can be passed in the `customFields` object. Field keys vary by organization — use the Config `/v1/config` endpoint or contact support to get the key names for a specific subdomain.

## Operations (45)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/parents/{parentId}/sign-agreements/{agreementId}` | Parent - Sign Agreement |
| GET | `/v1/parents/{parentId}/unsigned-agreements` | Parent - Unsigned Agreements |
| GET | `/v1/parents/{parentId}/signed-agreements` | Parent - Signed Agreements |
| GET | `/v1/parents/open-balance` | Parent - Open Balance |
| GET | `/v1/parents/{parentId}/card-on-file` | Card On File - Show |
| POST | `/v1/parents/{parentId}/card-on-file` | Card On File - Add |
| DELETE | `/v1/parents/{parentId}/card-on-file` | Card On File - Delete |
| PUT | `/v1/parents/{parentId}/card-on-file/{cardId}` | Card On File - Update |
| POST | `/v1/parents/{parentId}/parent-notes` | Parent Employee Notes - Create |
| PUT | `/v1/parents/{parentId}/parent-notes/{noteId}` | Parent Employee Notes - Update |
| GET | `/v1/parents/{parentId}` | Parents - Details |
| PUT | `/v1/parents/{parentId}` | Parents - Update |
| DELETE | `/v1/parents/{parentId}` | Parents - Delete |
| GET | `/v1/parents/online-status` | Parents - Online Status |
| GET | `/v1/parents/validate-phone` | Parent - Validate Phone |
| GET | `/v1/parents/validate-email` | Parent - Validate Email |
| GET | `/v1/parents` | Parents - List |
| POST | `/v1/parents` | Parents - Create |
| GET | `/v1/parents/unsigned-agreements/{agreementTypeId}` | Parents - Unsigned Agreements by Type |
| GET | `/v1/parents/{parentId}/parent-files` | Parent Files - List |
| POST | `/v1/parents/{parentId}/parent-files` | Parents - Upload File |
| GET | `/v1/parents/parent-files` | Parent Files - Search |
| POST | `/v1/parents/merge` | Parents - Merge |
| GET | `/v1/parents/{parentId}/parent-subscriptions` | Parents - Subscriptions |
| POST | `/v1/parents/{parentId}/parent-subscriptions` | Parent Subscriptions - Create |
| POST | `/v1/parents/{parentId}/parent-memberships` | Parents - Enroll Membership |
| GET | `/v1/parents/{parentId}/booking-types/{bookingTypeId}/rates` | Parents - Booking Type Rate |
| GET | `/v1/parents/parent-memberships` | Parent Memberships - List |
| GET | `/v1/parents/parent-memberships/{parentMembershipId}` | Parent Memberships - Detail |
| DELETE | `/v1/parents/parent-memberships/{parentMembershipId}` | Parent Memberships - Cancel |
| GET | `/v1/parents/parent-packages` | Parent Packages - List |
| GET | `/v1/parents/parent-packages/{parentPackageId}` | Parent Package - Details |
| POST | `/v1/parents/{parentId}/parent-packages` | Parent Packages - Purchase |
| GET | `/v1/parents/{parentId}/preferences` | Parents Preferences - Details |
| PUT | `/v1/parents/{parentId}/preferences` | Parents Preferences - Update |
| GET | `/v1/parents/{parentId}/custom-rates` | Parent - Custom Rates |
| GET | `/v1/parents/{parentId}/reward-points` | Parent - Reward Points |
| POST | `/v1/parents/{parentId}/reward-points` | Reward Points - Add |
| GET | `/v1/parents/reward-points-redemption` | Reward Points Redemption - List |
| DELETE | `/v1/parents/{parentId}/reward-points/{points}` | Parent Reward Points - Delete |
| POST | `/v1/parents/{parentId}/reward-points/redeem` | Reward Points - Redeem |
| POST | `/v1/parents/{parentId}/store-credit` | Store Credit - Add |
| GET | `/v1/parents/store-credit` | Store Credit - List |
| GET | `/v1/parents/{parentId}/store-credit/balance` | Store Credit - Remaining Balance |
| GET | `/v1/parents/subscriptions/{subscriptionId}` | Subscription - Details |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gingr/refs/heads/main/openapi/gingr-parents-api-openapi.yml
- **Documentation** — https://docs.gingr.io/documentation
- **Documentation** — https://support.gingrapp.com/hc/en-us/sections/26779521691661-Gingr-s-API

## Other Gingr APIs (11)

- [Gingr Invoices API](https://apis.io/apis/gingr/gingr-invoices-api/)
- [Gingr Payments API](https://apis.io/apis/gingr/gingr-payments-api/)
- [Gingr Pets API](https://apis.io/apis/gingr/gingr-pets-api/)
- [Gingr Booking Type Rates API](https://apis.io/apis/gingr/gingr-booking-type-rates-api/)
- [Gingr Bookings API](https://apis.io/apis/gingr/gingr-bookings-api/)
- [Gingr Card On File API](https://apis.io/apis/gingr/gingr-card-on-file-api/)
- [Gingr Config API](https://apis.io/apis/gingr/gingr-config-api/)
- [Gingr Group Classes API](https://apis.io/apis/gingr/gingr-group-classes-api/)
- [Gingr Payment API](https://apis.io/apis/gingr/gingr-payment-api/)
- [Gingr Precheck API](https://apis.io/apis/gingr/gingr-precheck-api/)
- [Gingr Upload API](https://apis.io/apis/gingr/gingr-upload-api/)

## Tags

Parents

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/gingr/gingr-parents-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/gingr/.