Gingr

Gingr Config API

The **Config** group exposes read and write endpoints for all organization-level configuration data in Gingr. This includes the lookup tables and settings that everything else depends on — species, breeds, booking types, service options, feeding options, immunization types, forms, locations, hours of operation, tax rates, areas, disabled dates, and more. Typically you will call these endpoints once at startup (or on a periodic refresh) to build local caches that your integration can reference when creating bookings, parents, and pets. Most config data changes infrequently and is safe to cache for hours or even days. Key things to know: - **Booking Types** define the kinds of services a location offers (e.g., Boarding, Daycare, Grooming). A booking must reference a valid booking type for the target location. - **Service Options** are add-ons that can be attached to a booking (e.g., extra walks, nail trim). Each service option belongs to a booking type. - **Forms** are questionnaires associated with bookings or animals. Form answers are collected during the pre-check process. - **Areas / Runs** represent physical kennel spaces. Lodging availability and capacity constraints live here. - **Tax Rates** define the tax rules applied when invoicing. Whether tax is applied to a booking depends on organization settings. - **Disabled Dates** let you know when a location is closed so you can avoid booking on those days.

GitHub OpenAPI

Operations 71

GET /v1/config/account-codes Account Codes - List #
GET /v1/config/agreement-templates Agreement Templates - List #
GET /v1/config/areas Areas - List #
POST /v1/config/areas Areas - Create #
GET /v1/config/belonging-areas Belonging Areas - List #
GET /v1/config/belonging-types Belonging Types - List #
GET /v1/config/booking-categories Booking Category - List #
GET /v1/config/booking-categories/{bookingCategoryId} Booking Category - Details #
GET /v1/config/booking-types Booking Types - List #
GET /v1/config/booking-types/{bookingTypeId} Booking Type - Details #
GET /v1/config/breeds Breeds - List #
POST /v1/config/breeds Breeds - Create #
GET /v1/config/breeds/{breedId} Breeds - Detail #
DELETE /v1/config/clear-cache Clear application cache #
GET /v1/config/cancellation-reasons Cancellation Reasons - List #
POST /v1/config/cancellation-reasons Cancellation Reasons - Create #
GET /v1/config/deposit-dates Deposit Dates - List #
GET /v1/config/disabled-dates Disabled Dates - List #
POST /v1/config/disabled-dates Disabled Dates - Create #
GET /v1/config/feeding-schedules Feeding Schedules - List #
GET /v1/config/feeding-methods Feeding Methods - List #
GET /v1/config/feeding-types Feeding Types - List #
GET /v1/config/feeding-amounts Feeding Amounts - List #
GET /v1/config/feeding-units Feeding Units - List #
GET /v1/config/booking-form Booking Form - List #
GET /v1/config/pet-form Pet Form - List #
GET /v1/config/parent-form Parent Form - Details #
GET /v1/config/hours/recurring Hours Recurring - List #
GET /v1/config/hours/specific-date Hours Of Operation - List #
GET /v1/config/immunization-types Immunization Types - List #
GET /v1/config/locations/{locationId} Location - Detail #
GET /v1/config/locations Location - List #
GET /v1/config/locations-pilot Locations Pilot - Mobile Inventor Only #
GET /v1/config/lodgings Lodgings - List #
GET /v1/config/medication-amounts Medication Amounts - List #
GET /v1/config/medication-schedules Medication Schedules - List #
GET /v1/config/medication-types Medication Types - List #
GET /v1/config/medication-units Medication Units - List #
GET /v1/config/membership-types Membership Types - List #
GET /v1/config/membership-types/{membershipTypeId} Membership Types - Detail #
GET /v1/config/open-item-types Open Item Types - List #
PUT /v1/config/open-item-types/{itemId} Open Item Types - Update #
GET /v1/config/organization-groups Organization Groups - List #
GET /v1/config/package-types Package Types - List #
GET /v1/config/package-types/{packageTypeId} [BETA - Not Production Ready] Package Types - Details #
GET /v1/config/payment-methods Payment Methods - List #
GET /v1/config/promotion-types Promotion Types - List #
POST /v1/config/promotion-types Promotion Types - Create #
GET /v1/config/promotion-types/{promotionTypeId} Promotion Types - Show #
GET /v1/config/referral-sources Referral Sources - List #
POST /v1/config/referral-sources Referral Sources - Create #
GET /v1/config/refund-reasons Refund Reasons - List #
POST /v1/config/refund-reasons Refund Reasons - Create #
GET /v1/config/regions Regions - List #
GET /v1/config/report-card-form Report Card Form - Details #
GET /v1/config/retail-types Retail Types - List #
GET /v1/config/retail-types/{retailTypeId} Retail Types - Detail #
GET /v1/config/reward-points Reward Points - Configuration #
GET /v1/config/service-options Service Options - List #
DELETE /v1/config/service-options/{serviceOptionId} Service Options - Delete #
GET /v1/config/service-types Service Types - List #
GET /v1/config/service-types/{serviceTypeId} Service Type - Details #
GET /v1/config/service-type-rates Service Type Rates - List #
GET /v1/config/species Species - List #
POST /v1/config/species Species - Create #
GET /v1/config/tax-rates Tax Rates - List #
GET /v1/config/temperament-types Temperament Types - List #
POST /v1/config/temperament-types Temperament Types - Create #
GET /v1/config/vets Vets - List #
POST /v1/config/vets Vets - Create #
PUT /v1/config/vets/{vetId} Vets - Update #

Documentation

📖
Documentation
https://docs.gingr.io/documentation
📖
Documentation
https://support.gingrapp.com/hc/en-us/sections/26779521691661-Gingr-s-API

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/gingr/refs/heads/main/openapi/gingr-config-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/gingr:gingr-config-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

gingr-config-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Gingr Config API
  description: 'Welcome to the **Gingr API** — a RESTful JSON:API-compliant interface for integrating with Gingr, the leading pet-care business management platform.


    ## Authentication


    All requests require an API key passed in the `X-Api-Key` header. Keys are scoped to a specific organization and can be generated from the Gingr admin dashboard under **Settings → Integrations → API Keys**.


    ## Subdomain Header


    Every request must also include a `subdomain` header identifying which Gingr account you are operating on. This value is the subdomain portion of your Gingr URL (e.g., `mykennel` for `mykennel.gingrapp.com`).


    ## Response Format


    The API follows the JSON:API v1.0 specification. All requests must include:


    ```

    Accept: application/vnd.api+json

    ```


    POST/PUT/PATCH requests that include a body must also include:


    ```

    Content-Type: application/vnd.api+json

    ```


    Paginated list responses include a `meta` object with `currentPage`, `lastPage`, `perPage`, and `total`, as well as a `links` object with `first`, `last`, `prev`, and `next` cursor URLs.


    ## Error Handling


    | HTTP Status | Meaning |

    |-------------|---------|

    | 200 | Success |

    | 201 | Resource created |

    | 400 | Bad request / business logic error |

    | 401 | Unauthorized — invalid or missing API key |

    | 403 | Forbidden — valid key but insufficient permissions |

    | 404 | Resource not found |

    | 422 | Validation error — see `errors` array in response |

    | 500 | Internal server error |


    Validation errors (`422`) are returned as a JSON:API `errors` array where each item contains a `title` and a `detail` describing the offending field.


    ## Rate Limiting


    API requests are subject to rate limiting. Exceeding the limit returns a `429 Too Many Requests` response. Contact Gingr support to discuss higher rate limits for high-volume integrations.'
  version: 1.9.2
tags:


# --- truncated at 32 KB (435 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/gingr/refs/heads/main/openapi/gingr-config-api-openapi.yml