Developer Section

REST API Specification & Reference

Comprehensive REST API specification with full request parameters, data types, possible enum values, response schemas, and machine-readable endpoints for external consumer integrations.

Authentication & Security

Protected endpoints require a valid API token associated with your breeder.cloud account. Manage your API tokens in Account Settings → API Tokens.

Bearer Token (Recommended)

Send the token via the standard HTTP Authorization: Bearer bc_live_... header.

X-Api-Token Header

Send the token via custom HTTP header X-Api-Token: bc_live_....

Query Parameter

Append token as query parameter ?token=bc_live_... for media downloads or simple webhooks.

Authentication Methods Example
# Authenticate using standard Authorization Bearer header
curl -X GET "https://breeder.cloud/api/v1/animals" \
  -H "Authorization: Bearer bc_live_9f83a04b12c84918e"

# Alternatively, authenticate using X-Api-Token custom header
curl -X GET "https://breeder.cloud/api/v1/animals" \
  -H "X-Api-Token: bc_live_9f83a04b12c84918e"

# Or using query parameter token
curl -X GET "https://breeder.cloud/api/v1/animals?token=bc_live_9f83a04b12c84918e"
Standard Error Response Envelope
{
  "success": false,
  "error": "Unauthorized",
  "message": "Missing authentication token. Provide your token via 'Authorization: Bearer <token>' header."
}

API Endpoints Specification

Complete list of available REST API routes with request parameters, payload formats, and response examples.

Tag:
Method:
Showing 37 of 37 endpointsBase URL: https://breeder.cloud

Retrieve a paginated, filterable list of animals owned by the authenticated breeder. Supports search by name, microchip, or registration, and filtering by sex, status, breeding availability, race, and color.

Request Parameters

ParameterInTypeRequiredDescription
organizationIdquerystringNoOrganization ID or slug to scope animal query (requires Admin/Owner rights on the organization).
scopequerystringNoScope of animals to retrieve (owned only, shared with organization only, or all accessible).
Allowed:ownedsharedall
Default: owned
pagequeryintegerNoPage number (1-based).
Default: 1
limitqueryintegerNoMaximum number of animals per page (1 to 100).
Default: 20
searchquerystringNoFilter by animal name, full name, registration number, association ID, or microchip.
associationIdquerystringNoFilter animals by association identification number or external parent association ID.
sexquerystringNoFilter by biological sex.
Allowed:femalemaleotherunknown
statusquerystringNoFilter by animal status.
Allowed:ACTIVEINACTIVEFUTURERETIRED
archivedquerybooleanNoInclude archived animals if true.
Default: false
forBreedingquerybooleanNoFilter animals intended for breeding program.
raceNamequerystringNoFilter by specific singular breed or race name (supports alias 'breed').
racePluralquerystringNoFilter by specific plural breed or race name (supports alias 'breedPlural').
colorNamequerystringNoFilter by color pattern.
sortByquerystringNoField to sort by.
Allowed:namedateOfBirthcreatedAtupdatedAtstatusraceNamesex
Default: createdAt
sortOrderquerystringNoSort direction.
Allowed:ascdesc
Default: desc
langquerystringNoLanguage code for localized medical tests (e.g. 'en', 'nl').

Response Formats

200Successfully retrieved list of animals.
Schema: AnimalListResponse
Response Example (200)
{
  "success": true,
  "data": [
    {
      "id": "cly1abc1230001xyz",
      "name": "Bella",
      "nameFull": "Bella of Highland Kennels",
      "sex": "female",
      "raceName": "Golden Retriever",
      "racePlural": "Golden Retrievers",
      "colorName": "Golden Sable",
      "status": "ACTIVE",
      "forBreeding": true,
      "archived": false,
      "dateOfBirth": "2023-04-12T00:00:00.000Z",
      "microchipId": "528140000123456",
      "registrationId": "NHSB-3289104",
      "motherAssociationId": "ALAEU-M-9988",
      "fatherAssociationId": "ALAEU-F-7766",
      "image": "https://r2.breeder.cloud/animals/bella.webp",
      "excerpt": "Top-ranked female with complete health test clearance.",
      "certificationNumbers": [
        {
          "id": "cly_acn_001",
          "animalId": "cly1abc1230001xyz",
          "certificationId": "cly_cert_alaeu",
          "identificationNumber": "ALAEU-12345",
          "certification": {
            "id": "cly_cert_alaeu",
            "title": "ALAEU (Australian Labradoodle Association Europe)",
            "type": "ASSOCIATION",
            "hasIdentificationSystem": true
          }
        }
      ],
      "preset": {
        "id": "cly_preset_dog",
        "name": "Golden Retriever",
        "namePlural": "Golden Retrievers",
        "breed": "Golden Retriever",
        "breedPlural": "Golden Retrievers",
        "animal": "Dog",
        "animalPlural": "Dogs"
      }
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}
401Unauthorized - missing or invalid API token.
403Forbidden - user does not have Admin rights on the organization.

Integration Code Examples

cURL Command
curl -X GET "https://breeder.cloud/api/v1/animals?status=ACTIVE&limit=10" \
  -H "Authorization: Bearer bc_live_your_token_here"
JavaScript / TypeScript (Fetch)
const res = await fetch("https://breeder.cloud/api/v1/animals?status=ACTIVE", {
  headers: { "Authorization": "Bearer " + process.env.BREEDER_CLOUD_API_TOKEN }
});
const { data, pagination } = await res.json();

Fetch CMS design theme tokens, custom favicon URL, color palettes, typography, header/footer layouts, and supported languages for building client websites.

Request Parameters

ParameterInTypeRequiredDescription
idpathstringYesOrganization ID or slug.

Response Formats

200Template configuration details.
Schema: CmsTemplate
Response Example (200)
{
  "success": true,
  "data": {
    "id": "tmpl_123",
    "organizationId": "cly_org_highland",
    "name": "Default Template",
    "favicon": "https://r2.breeder.cloud/favicons/kennel-icon.png",
    "theme": "modern",
    "primaryColor": "#059669",
    "secondaryColor": "#0284c7",
    "fontFamily": "Inter, sans-serif",
    "borderRadius": "md",
    "headingFont": "Playfair Display",
    "bodyFont": "Inter",
    "h1Color": "#064e3b",
    "bodyTextColor": "#334155",
    "linkTextColor": "#059669",
    "headerStyle": "sticky",
    "footerStyle": "columns",
    "defaultLanguage": "en",
    "supportedLanguages": [
      "en",
      "nl"
    ],
    "defaultBreed": "Golden Retriever",
    "defaultBreedPlural": "Golden Retrievers",
    "defaultPresetId": "cly_preset_dog",
    "resolvedColors": {
      "primary": {
        "hex": "#059669",
        "rgb": "5 150 105",
        "className": "bg-emerald-600"
      },
      "secondary": {
        "hex": "#0284c7",
        "rgb": "2 132 199",
        "className": "bg-sky-600"
      }
    },
    "resolvedTextColors": {
      "h1": {
        "hex": "#064e3b",
        "rgb": "6 78 59",
        "className": "text-emerald-900"
      },
      "body": {
        "hex": "#334155",
        "rgb": "51 65 85",
        "className": "text-slate-700"
      }
    },
    "resolvedGoogleFonts": {
      "headingFont": "Playfair Display",
      "bodyFont": "Inter",
      "fonts": [
        "Inter",
        "Playfair Display"
      ]
    }
  }
}
401Unauthorized - missing or invalid API token.
403Forbidden - user does not have Admin rights on the organization.
404Organization or template not found.

Integration Code Examples

cURL Command
curl -X GET "https://breeder.cloud/api/v1/organizations/highland-kennels/template" \
  -H "Authorization: Bearer bc_live_your_token_here"
JavaScript / TypeScript (Fetch)
const res = await fetch("https://breeder.cloud/api/v1/organizations/highland-kennels/template", {
  headers: { "Authorization": "Bearer " + process.env.BREEDER_CLOUD_API_TOKEN }
});
const { data: template } = await res.json();

Data Types & Entity Schemas

Structured schemas and field data types returned by the REST API entities, with required flags and sample payloads.

Animal

39 properties

Core pedigree and animal record representing an individual animal in breeder.cloud.

Field NameTypeRequiredDescriptionSample Value
idstringYesUnique CUID identifier of the animal.cly1abc1230001xyz
ownerIdstringYesUser ID of the animal owner/breeder.usr_123456
presetIdstring| nullOptionalAssociated biological species/breed preset ID.cly_preset_dog
namestring| nullOptionalOfficial call name of the animal.Bella
nameFullstring| nullOptionalOfficial pedigree or kennel club registered name.Bella of Highland Kennels
dateOfBirthstring| nullOptionalDate of birth (ISO 8601).2023-04-12T00:00:00.000Z
dateOfDeathstring| nullOptionalDate of death if deceased (ISO 8601).null
placeOfBirthstring| nullOptionalTwo-letter ISO2 country code where the animal was born.NL
weightAtBirthnumber| nullOptionalBirth weight in grams.380
sexstring| nullOptionalBiological sex of the animal.
Values:femalemaleotherunknown
female
colorNamestring| nullOptionalCoat or plumage color description.Golden Sable
raceNamestring| nullOptionalBreed or race name (singular).Golden Retriever
racePluralstring| nullOptionalBreed or race name (plural).Golden Retrievers
presetobject| nullOptionalAssociated biological species/breed preset details.{"id":"cly_preset_dog","name":"Golden Retriever","namePlural":"Golden Retrievers","breed":"Golden Retriever","breedPlural":"Golden Retrievers","animal":"Dog","animalPlural":"Dogs"}
dnaProfilestring| nullOptionalISAG / DNA identification profile code.DNA-ISAG-2024-8849
colorDnastring| nullOptionalCoat color genetics genotype string.e/e B/B D/D ky/ky ay/a
sizestring| nullOptionalSize category or measured height.Medium (54 cm)
coatstring| nullOptionalCoat texture or length type.Long / Dense
statusstringYesBreeding and lifecycle status.
Values:ACTIVEINACTIVEFUTURERETIRED
ACTIVE
breederstring| nullOptionalBreeder or kennel name of origin.Highland Kennels
passportIdstring| nullOptionalPet passport or official veterinary document number.NL-2023-88124
registrationIdstring| nullOptionalKennel club / studbook registration number.NHSB-3289104
microchipIdstring| nullOptional15-digit ISO 11784/11785 electronic microchip number.528140000123456
forBreedingboolean| nullOptionalWhether the animal is approved or intended for active breeding.
archivedbooleanYesWhether the animal has been archived from active listings.
imagestring| nullOptionalPrimary profile image URL.https://r2.breeder.cloud/animals/bella-profile.webp
descriptionstring| nullOptionalFull bio, temperament description, and accolades.Calm and friendly temperament, excellent retriever instincts.
excerptstring| nullOptionalShort summary used in cards and public listings.Top-ranked female with complete health test clearance.
motherIdstring| nullOptionalID of the biological mother (Dam).cly_dam_001
motherNamestring| nullOptionalName of the external mother (Dam).Highland Princess Luna
motherBreedstring| nullOptionalBreed of the external mother (Dam).Golden Retriever
motherAssociationIdstring| nullOptionalAssociation / registration ID of external mother (Dam).NHSB-3109281
fatherIdstring| nullOptionalID of the biological father (Sire).cly_sire_001
fatherNamestring| nullOptionalName of the external father (Sire).Highland Duke Oliver
fatherBreedstring| nullOptionalBreed of the external father (Sire).Golden Retriever
fatherAssociationIdstring| nullOptionalAssociation / registration ID of external father (Sire).NHSB-2984712
certificationNumbersAnimalCertificationNumber[]OptionalOfficial breed association and kennel club registration numbers with association name and details.[{"id":"cly_acn_001","animalId":"cly1abc1230001xyz","certificationId":"cly_cert_alaeu","identificationNumber":"ALAEU-12345","certification":{"id":"cly_cert_alaeu","title":"ALAEU (Australian Labradoodle Association Europe)","type":"ASSOCIATION","hasIdentificationSystem":true}}]
createdAtstringYesRecord creation timestamp.2024-01-10T12:00:00.000Z
updatedAtstringYesRecord last update timestamp.2024-04-15T09:30:00.000Z

Organization

40 properties

Breeder kennel, cattery, or stud organization entity hosting CMS websites.

Field NameTypeRequiredDescriptionSample Value
idstringYesOrganization CUID identifier.cly_org_highland
namestringYesOfficial business or kennel name.Highland Kennels
slugstringYesUnique URL slug for public routing.highland-kennels
logostring| nullOptionalLogo image URL.https://r2.breeder.cloud/logos/highland.webp
emailstring| nullOptionalContact email address.contact@highlandkennels.com
showEmailbooleanOptionalWhether to show email on public site.
phonestring| nullOptionalContact phone number.+31 6 12345678
showPhonebooleanOptionalWhether to show phone on public site.
addressstring| nullOptionalPhysical street address.Dorpsstraat 42
addressOptionalstring| nullOptionalOptional address line 2 / suite / building number.Suite 4B
citystring| nullOptionalCity or municipality.Utrecht
zipCodestring| nullOptionalPostal code.3511 AA
countrystring| nullOptionalTwo-letter ISO2 country code.NL
showAddressbooleanOptionalWhether to display address publicly.
cocIdstring| nullOptionalChamber of Commerce / KvK registration number.88392014
showCocIdbooleanOptionalWhether to display Chamber of Commerce / KvK registration publicly.
vatIdstring| nullOptionalValue Added Tax (VAT) / BTW number.NL88392014B01
showVatIdbooleanOptionalWhether to display VAT / BTW number publicly.
ubnstring| nullOptionalUnique Business Number (UBN), the Dutch livestock farm registration number.54321
showUbnbooleanOptionalWhether to display the Unique Business Number (UBN) publicly.
websitestring| nullOptionalCustom domain or main website URL.https://highlandkennels.com
showWebsitebooleanOptionalWhether to display website link publicly.
facebookstring| nullOptionalFacebook page URL.https://facebook.com/highlandkennels
showFacebookbooleanOptionalWhether to display Facebook link publicly.
instagramstring| nullOptionalInstagram handle or URL.https://instagram.com/highlandkennels
showInstagrambooleanOptionalWhether to display Instagram link publicly.
youtubestring| nullOptionalYouTube channel URL.https://youtube.com/@highlandkennels
showYoutubebooleanOptionalWhether to display YouTube channel publicly.
tiktokstring| nullOptionalTikTok profile URL.https://tiktok.com/@highlandkennels
showTiktokbooleanOptionalWhether to display TikTok profile publicly.
xTwitterstring| nullOptionalX / Twitter profile URL.https://x.com/highlandkennels
showXTwitterbooleanOptionalWhether to display X / Twitter profile publicly.
pintereststring| nullOptionalPinterest profile URL.https://pinterest.com/highlandkennels
showPinterestbooleanOptionalWhether to display Pinterest profile publicly.
linkedinstring| nullOptionalLinkedIn company / profile URL.https://linkedin.com/company/highlandkennels
showLinkedinbooleanOptionalWhether to display LinkedIn profile publicly.
webhookUrlstring| nullOptionalConfigured cache invalidation webhook URL.https://highlandkennels.com/api/revalidate
webhookSecretstring| nullOptionalSecret used to HMAC-sign cache invalidation webhook payloads.whsec_live_9a8b7c6d5e4f3a2b
webhookEnabledbooleanOptionalWhether webhook delivery is enabled.
createdAtstringYesCreation date.2024-01-01T00:00:00.000Z

CmsTemplate

80 properties

Design system configuration, color palette, typography, favicon, and layout settings for the public website.

Field NameTypeRequiredDescriptionSample Value
idstringYesTemplate configuration CUID.tmpl_123
organizationIdstringYesAssociated organization ID.cly_org_highland
namestringOptionalTemplate profile or theme name.Default Template
faviconstring| nullOptionalCustom favicon URL displayed in browser tabs and bookmarks.https://r2.breeder.cloud/favicons/kennel-icon.png
faviconColorModestring| nullOptionalFavicon color mode: theme (primary color) or custom.theme
faviconCustomColorstring| nullOptionalCustom hex color used when faviconColorMode is custom.#2563eb
faviconBackgroundstring| nullOptionalOptional hex background color behind the favicon icon.#ffffff
faviconShapestring| nullOptionalFavicon background shape: square, rounded, or circle.circle
faviconIcostring| nullOptionalGenerated multi-size favicon.ico URL.https://r2.breeder.cloud/cms/org/favicon/favicon.ico
favicon16string| nullOptionalGenerated 16x16 PNG favicon URL.https://r2.breeder.cloud/cms/org/favicon/favicon-16x16.png
favicon32string| nullOptionalGenerated 32x32 PNG favicon URL.https://r2.breeder.cloud/cms/org/favicon/favicon-32x32.png
favicon96string| nullOptionalGenerated 96x96 PNG favicon URL.https://r2.breeder.cloud/cms/org/favicon/favicon-96x96.png
faviconAppleTouchstring| nullOptionalGenerated 180x180 Apple touch icon URL.https://r2.breeder.cloud/cms/org/favicon/apple-touch-icon.png
faviconIcon192string| nullOptionalGenerated 192x192 Android/Chrome icon URL.https://r2.breeder.cloud/cms/org/favicon/icon-192.png
faviconIcon512string| nullOptionalGenerated 512x512 Android/Chrome icon URL.https://r2.breeder.cloud/cms/org/favicon/icon-512.png
faviconManifeststring| nullOptionalGenerated site.webmanifest URL.https://r2.breeder.cloud/cms/org/favicon/site.webmanifest
themestringOptionalVisual base theme (e.g., modern, classic, minimal, warm).modern
primaryColorstringYesHex / Tailwind primary accent color.emerald-600
secondaryColorstringYesHex / Tailwind secondary complementary color.slate-600
accentColorstringOptionalAccent highlight color.amber-500
backgroundColorstring| nullOptionalCustom background color code.slate-50
textColorstring| nullOptionalCustom base text color code.slate-900
mutedColorstringOptionalMuted surface background color.slate-100
borderColorstringOptionalBorder and divider color.slate-200
navbarColorstringOptionalNavbar / header background color.white
footerColorstringOptionalFooter background color.slate-900
fontFamilystringYesBody text font family.Inter, sans-serif
borderRadiusstringOptionalBorder radius style for UI elements (none, sm, md, lg, xl, full).md
customColorsobject| nullOptionalCustom color overrides JSON object.null
headingFontFamilystring| nullOptionalHeading font family.Playfair Display, serif
headingFontstringOptionalPrimary heading font family.Playfair Display
bodyFontstringOptionalBase body text font family.Inter
h1Fontstring| nullOptionalSpecific font for H1 headings.null
h2Fontstring| nullOptionalSpecific font for H2 headings.null
h3Fontstring| nullOptionalSpecific font for H3 headings.null
h4Fontstring| nullOptionalSpecific font for H4 headings.null
h5Fontstring| nullOptionalSpecific font for H5 headings.null
h6Fontstring| nullOptionalSpecific font for H6 headings.null
quoteFontstring| nullOptionalSpecific font for blockquotes.null
customFontsobject| nullOptionalCustom font overrides JSON object.null
fontCssUrlstring| nullOptionalSelf-hosted Google Fonts stylesheet on our CDN. Null until the fonts have been synced after a save.https://fonts.breeder.cloud/cms/org_1/fonts.css?v=1700000000000
fontCssVersionstring| nullOptionalCache-busting token for the self-hosted font stylesheet.1700000000000
fontsHostedAtstring| nullOptionalWhen the fonts were last uploaded to our CDN. Null if never synced.2024-01-01T00:00:00.000Z
h1ColorstringOptionalH1 heading text color.slate-900
h2ColorstringOptionalH2 heading text color.slate-900
h3ColorstringOptionalH3 heading text color.slate-900
h4ColorstringOptionalH4 heading text color.slate-800
h5ColorstringOptionalH5 heading text color.slate-800
h6ColorstringOptionalH6 heading text color.slate-700
bodyTextColorstringOptionalBody paragraph text color.slate-700
mutedTextColorstringOptionalMuted text color.slate-500
linkTextColorstringOptionalHyperlink text color.blue-600
linkHoverColorstringOptionalHyperlink hover state color.blue-700
captionTextColorstringOptionalCaption and small helper text color.slate-400
customTextColorsobject| nullOptionalCustom text color overrides JSON object.null
headerTextColorstringOptionalHeader text color.slate-900
headerLinkColorstringOptionalHeader link color.blue-600
headerLinkHoverColorstringOptionalHeader link hover color.blue-700
headerMutedColorstringOptionalHeader muted / secondary text color.slate-500
headerBorderColorstringOptionalHeader border color.slate-200
footerTextColorstringOptionalFooter body text color.slate-300
footerHeadingColorstringOptionalFooter section heading color.white
footerLinkColorstringOptionalFooter link color.slate-300
footerLinkHoverColorstringOptionalFooter link hover color.white
footerMutedColorstringOptionalFooter muted / copyright text color.slate-400
footerBorderColorstringOptionalFooter border and divider color.slate-800
headerStylestringOptionalHeader navigation style (simple, transparent, centered).sticky
footerStylestringOptionalFooter layout style.columns
customCssstring| nullOptionalCustom CSS stylesheet overrides.null
defaultLanguagestringYesDefault fallback locale code.en
supportedLanguagesstring[]YesList of enabled locale codes.["en","nl"]
defaultBreedstring| nullOptionalDefault singular animal breed name.Golden Retriever
defaultBreedPluralstring| nullOptionalDefault plural animal breed name.Golden Retrievers
defaultPresetIdstring| nullOptionalLinked default species/breed preset CUID.cly_preset_dog
defaultPresetobject| nullOptionalLinked default species/breed preset object.{"id":"cly_preset_dog","name":"Golden Retriever","namePlural":"Golden Retrievers","breed":"Golden Retriever","breedPlural":"Golden Retrievers"}
resolvedColorsobjectOptionalResolved CSS color variables and computed palettes.{"primary":{"hex":"#059669","rgb":"5 150 105","className":"bg-emerald-600"}}
resolvedTextColorsobjectOptionalResolved CSS text color variables.{"h1":{"hex":"#064e3b","rgb":"6 78 59","className":"text-emerald-900"}}
resolvedGoogleFontsobjectOptionalResolved font metadata. Load `stylesheetUrl` in the client website: it points at our CDN when fonts are self-hosted (`fontsHosted: true`), so no third-party request is made and no cookie consent is required.{"stylesheetUrl":"https://fonts.breeder.cloud/cms/org_1/fonts.css?v=1700000000000","googleStylesheetUrl":"https://fonts.googleapis.com/css2?family=Inter&display=swap","fontsHosted":true}
createdAtstringOptionalCreation timestamp.2024-01-01T00:00:00.000Z
updatedAtstringOptionalLast update timestamp.2024-01-01T00:00:00.000Z

CmsMarketingSettings

33 properties

Marketing configuration for the public website: analytics and advertising tags, cookie consent banner, conversion goals, WhatsApp widget, newsletter signup and the default social share image.

Field NameTypeRequiredDescriptionSample Value
idstringYesMarketing settings CUID.mkt_123
organizationIdstringYesAssociated organization ID.cly_org_highland
ga4MeasurementIdstring| nullOptionalGoogle Analytics 4 measurement ID. Requires cookie consent before loading.G-ABC123DEF
gtmContainerIdstring| nullOptionalGoogle Tag Manager container ID. Requires cookie consent before loading.GTM-ABC123
googleAdsIdstring| nullOptionalGoogle Ads conversion ID. Requires cookie consent before loading.AW-123456789
googleAdsLabelstring| nullOptionalGoogle Ads conversion label.AbC-D_efGhIjKlMn
metaPixelIdstring| nullOptionalMeta (Facebook) pixel ID, 15-16 digits. Requires cookie consent before loading.123456789012345
cookieConsentEnabledbooleanYesWhether the cookie consent banner is shown. Must be true before analytics or advertising cookies may be set.
consentModeV2booleanYesWhether Google Consent Mode v2 is used, keeping analytics denied until the visitor accepts.
consentTitlestring| nullOptionalBanner title text.We use cookies
consentMessagestring| nullOptionalBanner body text.We use cookies to measure website traffic.
consentAcceptLabelstring| nullOptionalAccept button label.Accept
consentDeclineLabelstring| nullOptionalReject button label.Reject
consentPositionstringYesBanner position: bottom, bottom-left, bottom-right, top or center.bottom
consentLayoutstringYesBanner layout: bar (full width) or card (floating).bar
consentThemestringYesBanner theme: light, dark or template (match website colors).light
consentShowDeclinebooleanYesWhether a reject button is shown. Required for GDPR compliance.
whatsappEnabledbooleanYesWhether the floating WhatsApp button is shown.
whatsappNumberstring| nullOptionalWhatsApp number in international format, digits only (E.164 without +).31612345678
whatsappMessagestring| nullOptionalPre-filled chat message.Hi! I have a question about your puppies.
whatsappPositionstringYesButton position: bottom-left or bottom-right.bottom-right
newsletterEnabledbooleanYesWhether newsletter signup is enabled. Add a NEWSLETTER section to a page to place the form.
newsletterProviderstring| nullOptionalNewsletter provider: mailchimp, brevo, mailerlite or custom.mailchimp
newsletterActionUrlstring| nullOptionalForm action URL for the custom provider.https://mailchi.mp/xxxx/subscribe
newsletterTitlestring| nullOptionalNewsletter heading.Stay updated
newsletterDescriptionstring| nullOptionalNewsletter description.Get notified about new litters.
newsletterButtonLabelstring| nullOptionalNewsletter submit button label.Subscribe
ogDefaultImagestring| nullOptionalFallback Open Graph share image used when a page defines none.https://r2.breeder.cloud/cms/org_1/og-default.jpg
conversionGoalsobject[]| nullOptionalGA4 conversion events. Each item: { id?, eventName, trigger, label, enabled }.[{"eventName":"generate_lead","trigger":"CONTACT_FORM_SUBMIT","label":"Puppy inquiry","enabled":true}]
consentMissingTagsstring[]OptionalTracking tag fields that are set but not covered by the consent banner (ga4MeasurementId, gtmContainerId, googleAdsId, metaPixelId). Empty when compliant.[]
scriptsobjectOptionalReady-to-render helpers: consent config, GA4/GTM script sources, Google Ads, Meta Pixel, WhatsApp link, newsletter config and enabled events.{"consentRequired":false,"ga4":{"measurementId":"G-ABC123DEF","src":"https://www.googletagmanager.com/gtag/js?id=G-ABC123DEF"}}
createdAtstringOptionalCreation timestamp.2024-01-01T00:00:00.000Z
updatedAtstringOptionalLast update timestamp.2024-01-01T00:00:00.000Z

CmsTemplateInput

61 properties

Input payload for creating or updating website design system template, favicon, typography, and color tokens.

Field NameTypeRequiredDescriptionSample Value
namestringOptionalTemplate profile or theme name.Default Template
faviconstring| nullOptionalCustom favicon URL displayed in browser tabs and bookmarks.https://r2.breeder.cloud/favicons/kennel-icon.png
faviconColorModestring| nullOptionalFavicon color mode: theme (primary color) or custom.theme
faviconCustomColorstring| nullOptionalCustom hex color used when faviconColorMode is custom.#2563eb
faviconBackgroundstring| nullOptionalOptional hex background color behind the favicon icon.#ffffff
faviconShapestring| nullOptionalFavicon background shape: square, rounded, or circle.circle
themestringOptionalVisual base theme preset.modern
primaryColorstringOptionalHex / Tailwind primary accent color.emerald-600
secondaryColorstringOptionalHex / Tailwind secondary complementary color.slate-600
accentColorstringOptionalAccent highlight color.amber-500
backgroundColorstring| nullOptionalCustom background color code.slate-50
textColorstring| nullOptionalCustom base text color code.slate-900
mutedColorstringOptionalMuted surface background color.slate-100
borderColorstringOptionalBorder and divider color.slate-200
navbarColorstringOptionalNavbar / header background color.white
footerColorstringOptionalFooter background color.slate-900
fontFamilystringOptionalBody text font family.Inter, sans-serif
borderRadiusstringOptionalBorder radius style for UI elements.md
customColorsobject| nullOptionalCustom color overrides JSON object.null
headingFontFamilystring| nullOptionalHeading font family.Playfair Display, serif
headingFontstringOptionalPrimary heading font family.Playfair Display
bodyFontstringOptionalBase body text font family.Inter
h1Fontstring| nullOptionalSpecific font for H1 headings.null
h2Fontstring| nullOptionalSpecific font for H2 headings.null
h3Fontstring| nullOptionalSpecific font for H3 headings.null
h4Fontstring| nullOptionalSpecific font for H4 headings.null
h5Fontstring| nullOptionalSpecific font for H5 headings.null
h6Fontstring| nullOptionalSpecific font for H6 headings.null
quoteFontstring| nullOptionalSpecific font for blockquotes.null
customFontsobject| nullOptionalCustom font overrides JSON object.null
h1ColorstringOptionalH1 heading text color.slate-900
h2ColorstringOptionalH2 heading text color.slate-900
h3ColorstringOptionalH3 heading text color.slate-900
h4ColorstringOptionalH4 heading text color.slate-800
h5ColorstringOptionalH5 heading text color.slate-800
h6ColorstringOptionalH6 heading text color.slate-700
bodyTextColorstringOptionalBody paragraph text color.slate-700
mutedTextColorstringOptionalMuted text color.slate-500
linkTextColorstringOptionalHyperlink text color.blue-600
linkHoverColorstringOptionalHyperlink hover state color.blue-700
captionTextColorstringOptionalCaption and small helper text color.slate-400
customTextColorsobject| nullOptionalCustom text color overrides JSON object.null
headerTextColorstringOptionalHeader text color.slate-900
headerLinkColorstringOptionalHeader link color.blue-600
headerLinkHoverColorstringOptionalHeader link hover color.blue-700
headerMutedColorstringOptionalHeader muted / secondary text color.slate-500
headerBorderColorstringOptionalHeader border color.slate-200
footerTextColorstringOptionalFooter body text color.slate-300
footerHeadingColorstringOptionalFooter section heading color.white
footerLinkColorstringOptionalFooter link color.slate-300
footerLinkHoverColorstringOptionalFooter link hover color.white
footerMutedColorstringOptionalFooter muted / copyright text color.slate-400
footerBorderColorstringOptionalFooter border and divider color.slate-800
headerStylestringOptionalHeader navigation style.sticky
footerStylestringOptionalFooter layout style.columns
customCssstring| nullOptionalCustom CSS stylesheet overrides.null
defaultLanguagestringOptionalDefault fallback locale code.en
supportedLanguagesstring[]OptionalList of enabled locale codes.["en","nl"]
defaultBreedstring| nullOptionalDefault singular animal breed name.Golden Retriever
defaultBreedPluralstring| nullOptionalDefault plural animal breed name.Golden Retrievers
defaultPresetIdstring| nullOptionalLinked default species/breed preset CUID.cly_preset_dog

AnimalPreset

16 properties

Biological species and breed preset template defining singular and plural terminology.

Field NameTypeRequiredDescriptionSample Value
idstringYesPreset CUID identifier.cly_preset_dog
namestringYesSingular breed or preset name.Golden Retriever
namePluralstring| nullOptionalPlural breed or preset name.Golden Retrievers
breedstring| nullOptionalSingular breed name.Golden Retriever
breedPluralstring| nullOptionalPlural breed name.Golden Retrievers
racestring| nullOptionalSingular race or breed name.Golden Retriever
racePluralstring| nullOptionalPlural race or breed name.Golden Retrievers
animalstringYesSingular animal species name.Dog
animalPluralstringYesPlural animal species name.Dogs
femaleNamestringYesSingular female animal name.Dam
femaleNamePluralstringYesPlural female animal name.Dams
maleNamestringYesSingular male animal name.Sire
maleNamePluralstringYesPlural male animal name.Sires
youngNamestringYesSingular young animal name.Puppy
youngNamePluralstringYesPlural young animal name.Puppies
gestationnumberYesAverage gestation length in days.63

CmsPage

38 properties

Public CMS page model with modular section layouts.

Field NameTypeRequiredDescriptionSample Value
idstringYesUnique page CUID.cly_page_001
organizationIdstringYesOrganization ID.cly_org_highland
titlestringYesPublic page title.About Our Kennel
slugstringYesURL route path (e.g. 'home', 'about-us', 'contact').about-us
contentstringYesBase rich text or markdown content.<p>Welcome to Highland Kennels...</p>
publishedbooleanYesVisibility status on the public website.
isHomebooleanYesWhether this page serves as the root index page ('/').
excerptstring| nullOptionalPage summary used for SEO meta description.Learn about our 15 years of ethical breeding practices.
heroAlbumIdstring| nullOptionalOptional photo album ID used as hero background banner.null
heroTitlestring| nullOptionalTitle displayed in the hero overlay banner.Welcome to Highland Kennels
heroSubtitlestring| nullOptionalSubtitle displayed in the hero overlay banner.Dedicated to raising healthy, well-socialized Golden Retrievers.
heroButtonPrimaryTextstring| nullOptionalCall-to-action text for the primary hero button.Explore Puppies
heroButtonPrimaryLinkTypestring| nullOptionalLink resolution type for the primary hero button.
Values:PAGECUSTOM
PAGE
heroButtonPrimaryUrlstring| nullOptionalTarget custom URL for the primary hero button.null
heroButtonPrimaryPageIdstring| nullOptionalTarget CMS page ID for the primary hero button.cly_page_litters
heroButtonSecondaryTextstring| nullOptionalCall-to-action text for the secondary hero button.Contact Us
heroButtonSecondaryLinkTypestring| nullOptionalLink resolution type for the secondary hero button.
Values:PAGECUSTOM
CUSTOM
heroButtonSecondaryUrlstring| nullOptionalTarget custom URL for the secondary hero button./contact
heroButtonSecondaryPageIdstring| nullOptionalTarget CMS page ID for the secondary hero button.null
seoTitlestring| nullOptionalCustom SEO <title> tag override.About Highland Kennels | Ethical Breeder
seoDescriptionstring| nullOptionalCustom SEO <meta name="description"> tag.Learn about our 15 years of ethical pedigree Golden Retriever breeding practices.
seoKeywordsstring| nullOptionalComma-separated SEO keyword phrases.golden retriever, breeder, scotland, pedigree
canonicalUrlstring| nullOptionalCustom canonical URL override.https://highlandkennels.com/about-us
noIndexbooleanOptionalDisallow search engines indexing this page.
noFollowbooleanOptionalDisallow search engines following links on this page.
ogTitlestring| nullOptionalOpen Graph social sharing card title.About Highland Kennels
ogDescriptionstring| nullOptionalOpen Graph social sharing card description.Learn about our 15 years of ethical breeding practices.
ogImagestring| nullOptionalOpen Graph 1200x630 social share image URL.https://r2.breeder.cloud/facilities/yard.webp
ogTypestring| nullOptionalOpen Graph object type (e.g. 'website', 'article').website
twitterCardstring| nullOptionalTwitter / X card format.summary_large_image
twitterTitlestring| nullOptionalTwitter card title.About Highland Kennels
twitterDescriptionstring| nullOptionalTwitter card description.Learn about our 15 years of ethical breeding practices.
twitterImagestring| nullOptionalTwitter card preview image URL.https://r2.breeder.cloud/facilities/yard.webp
structuredDataTypestring| nullOptionalSchema.org structured data type (e.g. 'WebPage', 'AboutPage', 'ContactPage').AboutPage
structuredDataCustomobject| nullOptionalCustom JSON-LD schema overrides.null
translationsobject| nullOptionalLocalized translations map for non-default content languages (e.g. Dutch).{"nl":{"title":"Over Ons","heroTitle":"Welkom bij Highland Kennels"}}
sectionsCmsSection[]OptionalOrdered list of modular sections.[]
createdAtstringYesCreation date.2024-01-15T10:00:00.000Z

CmsDynamicPageSeo

17 properties

Search Engine Optimization (SEO) rules and template strings for dynamic CMS pages in breeder.cloud.

Field NameTypeRequiredDescriptionSample Value
idstringOptionalDynamic SEO rule CUID.cly_seo_001
organizationIdstringOptionalOrganization ID.cly_org_highland
routeTypestringYesDynamic route identifier.
Values:ANIMALS_OVERVIEWALL_ACTIVE_FEMALESALL_ACTIVE_MALESANIMAL_PROFILE_DETAILLITTERS_OVERVIEWLITTER_DETAIL
ANIMALS_OVERVIEW
titleTemplatestringYesSEO title template with dynamic token tags.Our {breedPlural} | {orgName}
descriptionTemplatestringYesSEO meta description template with dynamic token tags.Meet all pedigree {breedPlural} raised at {orgName} in {orgCity}.
keywordsTemplatestring| nullOptionalSEO keyword tokens template.{breed}, {breedPlural}, {orgCity} breeder, pedigree
ogImagestring| nullOptionalFallback social share image URL.https://r2.breeder.cloud/branding/og-default.jpg
ogTypestringOptionalOpen Graph type.website
twitterCardstringOptionalTwitter card display type.summary_large_image
noIndexbooleanOptionalWhether to disallow search engine indexing.
noFollowbooleanOptionalWhether to disallow search engine crawling links.
structuredDataTypestringOptionalSchema.org structured data type.CollectionPage
isCustomizedbooleanOptionalWhether this route uses custom overrides rather than breed defaults.
interpolatedPreviewTitlestringOptionalSample resolved title preview.Our Golden Retrievers | Highland Kennels
interpolatedPreviewDescriptionstringOptionalSample resolved description preview.Meet all pedigree Golden Retrievers raised at Highland Kennels in Edinburgh.
createdAtstringOptionalCreation date.2024-01-15T10:00:00.000Z
updatedAtstringOptionalLast update timestamp.2024-01-15T10:00:00.000Z

CmsDynamicPageSeoInput

10 properties

Payload for configuring dynamic page SEO rules.

Field NameTypeRequiredDescriptionSample Value
routeTypestringYesDynamic route identifier.
Values:ANIMALS_OVERVIEWALL_ACTIVE_FEMALESALL_ACTIVE_MALESANIMAL_PROFILE_DETAILLITTERS_OVERVIEWLITTER_DETAIL
ANIMALS_OVERVIEW
titleTemplatestringYesSEO title template with dynamic token tags.Our {breedPlural} | {orgName}
descriptionTemplatestringYesSEO meta description template with dynamic token tags.Meet all pedigree {breedPlural} raised at {orgName} in {orgCity}.
keywordsTemplatestring| nullOptionalSEO keyword tokens template.{breed}, {breedPlural}, {orgCity} breeder, pedigree
ogImagestring| nullOptionalFallback social share image URL.https://r2.breeder.cloud/branding/og-default.jpg
ogTypestringOptionalOpen Graph type.website
twitterCardstringOptionalTwitter card display type.summary_large_image
noIndexbooleanOptionalWhether to disallow search engine indexing.
noFollowbooleanOptionalWhether to disallow search engine crawling links.
structuredDataTypestringOptionalSchema.org structured data type.CollectionPage

CmsSection

21 properties

Modular content block within a CMS page.

Field NameTypeRequiredDescriptionSample Value
idstringYesSection CUID.cly_sec_001
pageIdstringYesParent page ID.cly_page_001
titlestring| nullOptionalSection header title.Our Facilities & Care
subtitlestring| nullOptionalSection subtitle or tagline.Dedicated to excellence in ethical breeding.
descriptionstring| nullOptionalSection description or introduction text.Spacious grounds and dedicated puppy socialization nursery.
typestringYesSection layout widget type.
Values:DEFAULTANIMAL_SHOWCASECERTIFICATIONSCONTACT_FORM
DEFAULT
orderintegerYesDisplay sort order index.0
columnsCountintegerYesNumber of grid columns (1 to 6).2
animalShowcaseBreedstring| nullOptionalFilter showcased animals by breed/race name when type is ANIMAL_SHOWCASE.Golden Retriever
animalShowcaseSexstring| nullOptionalFilter showcased animals by sex ('FEMALE' or 'MALE') when type is ANIMAL_SHOWCASE.FEMALE
animalShowcaseStatusstring| nullOptionalFilter showcased animals by lifecycle status ('ACTIVE', 'INACTIVE', 'FUTURE', 'RETIRED') when type is ANIMAL_SHOWCASE.ACTIVE
animalIdstring| nullOptionalLinked animal ID for contextual contact form or showcase.null
waitingListIdstring| nullOptionalLinked waiting list ID for reservation form.null
formButtonTextstring| nullOptionalCustom submit button label on contact form.Send Message
formSuccessMessagestring| nullOptionalCustom confirmation message shown upon form submission.Thank you for reaching out! We will reply shortly.
formShowPhoneboolean| nullOptionalWhether to show the phone number input field in the contact form.
formShowSubjectboolean| nullOptionalWhether to show the subject input field in the contact form.
formLanguagestring| nullOptionalLanguage code for the form labels and validation.en
translationsobject| nullOptionalLocalized translations map for section text fields (title, subtitle, description, form buttons).{"nl":{"title":"Onze Faciliteiten","subtitle":"Toegewijd aan uitmuntendheid"}}
columnsCmsColumn[]OptionalColumns inside this section.[]
certificationsCmsCertification[]OptionalLinked certifications if type is CERTIFICATIONS.[]

CmsColumn

17 properties

Individual column card or widget within a CMS section.

Field NameTypeRequiredDescriptionSample Value
idstringYesColumn CUID.cly_col_001
sectionIdstringYesParent section ID.cly_sec_001
titlestring| nullOptionalColumn card title.Spacious Exercise Yard
contentstring| nullOptionalRich text content.<p>Over 5 acres of fenced agility grass...</p>
imageUrlstring| nullOptionalImage media URL.https://r2.breeder.cloud/facilities/yard.webp
imageAltstring| nullOptionalAccessibility alt text.Dogs running on grassy field
typestringYesColumn widget type.
Values:RICH_TEXTIMAGECUSTOMCERTIFICATIONCONTACT_FORM
RICH_TEXT
orderintegerYesColumn order within section.0
animalIdstring| nullOptionalLinked animal ID for column widget.null
waitingListIdstring| nullOptionalLinked waiting list ID for column widget.null
certificationIdstring| nullOptionalLinked certification ID if type is CERTIFICATION.null
formButtonTextstring| nullOptionalCustom submit button label on contact form column.null
formSuccessMessagestring| nullOptionalCustom confirmation message shown upon form submission.null
formShowPhoneboolean| nullOptionalWhether to show the phone number input field in the contact form column.
formShowSubjectboolean| nullOptionalWhether to show the subject input field in the contact form column.
formLanguagestring| nullOptionalLanguage code for the form labels and validation.en
translationsobject| nullOptionalLocalized translations map for column content (title, rich text HTML, captions, alt text).{"nl":{"title":"Ruime Speelweide","content":"<p>Meer dan 2 hectare...</p>"}}

CmsMenu

6 properties

Hierarchical navigation menu configuration.

Field NameTypeRequiredDescriptionSample Value
idstringYesMenu CUID.cly_menu_main
organizationIdstringYesOrganization ID.cly_org_highland
namestringYesDisplay name in dashboard.Main Header Menu
slugstringYesMachine slug identifier.main-header
locationstringYesRender placement.
Values:HEADERFOOTER
HEADER
itemsCmsMenuItem[]OptionalTop-level menu items with nested children.[]

CmsMenuItem

11 properties

Navigation link entry inside a CMS menu.

Field NameTypeRequiredDescriptionSample Value
idstringYesMenu item CUID.cly_item_01
menuIdstringYesParent menu ID.cly_menu_main
titlestringYesVisible button/link label.Our Sires & Dams
linkTypestringYesLink resolution type.
Values:CUSTOMPAGEDYNAMIC
DYNAMIC
urlstringYesTarget URL or path./animals
pageIdstring| nullOptionalTarget CMS page ID when linkType is PAGE.null
dynamicPagestring| nullOptionalDynamic target view identifier.
Values:ANIMALS_OVERVIEWALL_ACTIVE_FEMALESALL_ACTIVE_MALESLITTERS_OVERVIEW
ANIMALS_OVERVIEW
targetstringYesBrowser window target.
Values:_self_blank
_self
orderintegerYesSort order position.1
parentIdstring| nullOptionalParent menu item ID for dropdown sub-menus.null
childrenCmsMenuItem[]OptionalNested sub-menu items.[]

CmsPhotoAlbum

9 properties

Public photo gallery album.

Field NameTypeRequiredDescriptionSample Value
idstringYesAlbum CUID.cly_album_01
organizationIdstringYesOrganization ID.cly_org_highland
titlestringYesAlbum title.Spring 2024 Litter Gallery
slugstringYesURL slug.spring-2024-litter
descriptionstring| nullOptionalAlbum description.Photos of our puppies from 2 to 8 weeks old.
coverUrlstring| nullOptionalCover thumbnail URL.https://r2.breeder.cloud/albums/cover-01.webp
orderintegerYesSort order index.0
isPublicbooleanYesPublic visibility flag.
itemsCmsPhotoAlbumItem[]OptionalPhotos in album.[]

CmsPhotoAlbumItem

6 properties

Individual photo within an album.

Field NameTypeRequiredDescriptionSample Value
idstringYesPhoto item CUID.cly_photo_01
albumIdstringYesAlbum ID.cly_album_01
urlstringYesHigh resolution image URL.https://r2.breeder.cloud/albums/photo-1.webp
titlestring| nullOptionalPhoto title.Week 4 Garden Play
captionstring| nullOptionalCaption or description.Puppies exploring outdoor agility grass for the first time.
orderintegerYesDisplay sort order.0

CmsCertification

13 properties

Official breeder credentials, club memberships, and health certifications.

Field NameTypeRequiredDescriptionSample Value
idstringYesCertification CUID.cly_cert_01
organizationIdstringYesOrganization ID.cly_org_highland
typestringYesAccreditation type.
Values:CERTIFICATIONASSOCIATION
CERTIFICATION
titlestringYesCertificate or club title.FCI Official Kennel Accreditation
descriptionstring| nullOptionalDetails and certificate ID.Officially registered breeder with FCI and Dutch Kennel Club Raad van Beheer.
imageUrlstring| nullOptionalBadge or seal image URL.https://r2.breeder.cloud/badges/fci.webp
urlstring| nullOptionalVerification link URL.https://www.fci.be/kennel-verify/8849
expiresAtstring| nullOptionalExpiration date for the badge/media asset (ISO 8601).2028-12-31T23:59:59.000Z
memberSincestring| nullOptionalDate when membership in the association began (ISO 8601).2018-05-12T00:00:00.000Z
statusstringYesCalculated validity status.
Values:ACTIVEEXPIREDNO_EXPIRY
ACTIVE
isExpiredbooleanYesWhether the certificate is expired.
hasIdentificationSystembooleanOptionalWhether this certification/association tracks member or registration IDs for animals.
orderintegerYesDisplay sort order.0

CmsContactSubmission

14 properties

Lead capture and inbound inquiry message received from the public website contact form.

Field NameTypeRequiredDescriptionSample Value
idstringYesSubmission CUID.cly_sub_01
organizationIdstringYesOrganization ID.cly_org_highland
namestringYesSender's full name.Jane Doe
emailstringYesSender's email address.jane.doe@example.com
phonestring| nullOptionalSender's telephone number.+31 6 98765432
subjectstring| nullOptionalInquiry topic or subject line.Inquiry regarding Autumn 2024 Golden Retriever Litter
messagestringYesFull message content.Hello, we are looking for a female puppy for our active family...
languagestringYesLocale used when submitting.en
statusstringYesProcessing status.
Values:UNREADREADREPLIEDARCHIVED
UNREAD
animalIdstring| nullOptionalLinked animal ID if submitted from animal profile page.cly1abc1230001xyz
waitingListIdstring| nullOptionalLinked waiting list ID if created/reserved.null
pageIdstring| nullOptionalSource page ID.cly_page_001
metadataobject| nullOptionalCustom key-value metadata.{"source":"google_search"}
createdAtstringYesReceived timestamp.2024-05-01T14:22:00.000Z

SubmitContactFormInput

12 properties

Payload required to submit a public contact inquiry form.

Field NameTypeRequiredDescriptionSample Value
organizationIdstringYesTarget organization ID (or provided via ?org= query parameter).cly_org_highland
namestringYesSender's name (1 to 100 characters).Jane Doe
emailstringYesValid email address.jane.doe@example.com
messagestringYesInquiry message body (1 to 5000 characters).Hello, we are looking for an active family companion.
phonestringOptionalOptional contact phone number.+31 6 98765432
subjectstringOptionalOptional subject line.Puppy Reservation Question
pageIdstringOptionalID of the source page.cly_page_001
pageSlugstringOptionalSlug of the source page.about-us
animalIdstringOptionalTarget animal ID if inquiring about a specific sire/dam/puppy.cly1abc1230001xyz
waitingListIdstringOptionalTarget waiting list ID.null
languagestringOptionalForm locale code (default: 'en').en
metadataobjectOptionalArbitrary key-value metadata object.{"referrer":"instagram"}

AnimalWeightRecord

4 properties

Historical weigh-in record tracking animal growth and development over time.

Field NameTypeRequiredDescriptionSample Value
idintegerYesNumeric weight record ID.104
animalIdstringYesAnimal CUID.cly1abc1230001xyz
weightintegerYesRecorded weight value in grams.28400
timestampstringYesMeasurement timestamp.2024-03-01T08:00:00.000Z

AnimalMedicalRecord

9 properties

Veterinary diagnostic test result or health certificate attached to an animal.

Field NameTypeRequiredDescriptionSample Value
idstringYesMedical record CUID.cly_med_01
animalIdstringYesAnimal CUID.cly1abc1230001xyz
testNamestringYesRecorded test name.Hip Dysplasia (HD) Evaluation
resultstringYesDiagnostic score or result (e.g. HD-A, Clear, Negative).HD-A / Excellent (Norberg 40)
timestampstringYesExamination date.2024-02-15T11:00:00.000Z
veterinarianstring| nullOptionalExamining veterinarian or clinic.Dr. Van Dijk - Utrecht Animal Clinic
notesstring| nullOptionalClinical notes.No signs of arthrosis; bilateral symmetrical joints.
validUntilstring| nullOptionalExpiration date for annual certificates.null
localizedTestNamestringOptionalTranslated test name based on requested locale.Heupdysplasie (HD) Beoordeling

AnimalCertificationNumber

7 properties

Official registration or studbook identification number issued by an association or kennel club.

Field NameTypeRequiredDescriptionSample Value
idstringYesUnique CUID identifier of the association number record.cly_acn_001
animalIdstringYesCUID of the animal.cly1abc1230001xyz
certificationIdstringYesCUID of the organization association or certification.cly_cert_alaeu
identificationNumberstringYesIdentification or studbook registration number with the association.ALAEU-12345
certificationobject| nullOptionalLinked organization certification/association details including title, type, and badge.{"id":"cly_cert_alaeu","title":"ALAEU (Australian Labradoodle Association Europe)","type":"ASSOCIATION","hasIdentificationSystem":true}
createdAtstringYesCreation timestamp.2024-01-10T12:00:00.000Z
updatedAtstringYesLast update timestamp.2024-04-15T09:30:00.000Z

PaginationMetadata

4 properties

Standard pagination envelope returned by list queries.

Field NameTypeRequiredDescriptionSample Value
totalintegerYesTotal count of matching records across all pages.48
pageintegerYesCurrent page number (1-based).1
limitintegerYesMaximum records returned per page.20
totalPagesintegerYesTotal number of available pages.3

WebhookConfig

4 properties

Real-time cache invalidation webhook configuration for an organization.

Field NameTypeRequiredDescriptionSample Value
organizationIdstringYesOrganization CUID.cly_org_highland
webhookUrlstring| nullOptionalDestination URL receiving cache invalidation POST requests.https://highlandkennels.com/api/revalidate
webhookSecretstring| nullOptionalSecret token used to verify HMAC-SHA256 signatures.whsec_live_9a8b7c6d5e4f3a2b
webhookEnabledbooleanYesWhether webhook dispatching is active.

SetWebhookUrlInput

7 properties

Request payload used to set or update the client cache invalidation webhook URL.

Field NameTypeRequiredDescriptionSample Value
urlstring| nullOptionalWebhook endpoint URL (alias: webhookUrl).https://highlandkennels.com/api/revalidate
webhookUrlstring| nullOptionalWebhook endpoint URL.https://highlandkennels.com/api/revalidate
secretstring| nullOptionalOptional webhook secret for signature verification (alias: webhookSecret).whsec_live_9a8b7c6d5e4f3a2b
webhookSecretstring| nullOptionalOptional webhook secret for signature verification.whsec_live_9a8b7c6d5e4f3a2b
enabledbooleanOptionalWhether to enable webhook calls.
webhookEnabledbooleanOptionalWhether to enable webhook calls.
organizationIdstringOptionalOptional organization ID when calling root webhook endpoint.cly_org_highland

WebhookInvalidationPayload

8 properties

Payload delivered via HTTP POST to the client's configured webhook URL upon database changes.

Field NameTypeRequiredDescriptionSample Value
eventstringYesEvent identifier indicating cache invalidation.
Values:cache:invalidateinvalidate
cache:invalidate
actionstringYesDatabase mutation operation that triggered invalidation.
Values:createupdatedeleteupsertchange
update
modelstringYesAffected database model name.Animal
organizationIdstringYesOrganization CUID owning the changed entity.cly_org_highland
timestampstringYesISO 8601 UTC timestamp of the change event.2026-09-05T17:19:00.000Z
entityIdstring| nullOptionalCUID or ID of the affected entity.cly1abc1230001xyz
tagsstring[]YesCache invalidation tags suitable for Next.js revalidateTag or CDN tag purging.["animals","animal:cly1abc1230001xyz","organization:cly_org_highland"]
metadataobject| nullOptionalAdditional context about the mutation.{"operation":"update","slug":"bella"}

SalesContract

24 properties

Digital sales contract and legally binding purchase agreement for litter offspring.

Field NameTypeRequiredDescriptionSample Value
idstringYesUnique contract CUID identifier.cly_sc_001
contractNumberstringYesOfficial human-readable contract reference number.BC-SC-2026-0001
titlestringYesContract title.Puppy Sales Agreement - Bella Litter
statusstringYesCurrent lifecycle status of the contract.
Values:DRAFTSENTVIEWEDSIGNEDVOIDEDEXPIRED
SIGNED
templateIdstring| nullOptionalSource contract template CUID.cly_tmpl_001
matchIdstring| nullOptionalAssociated breeding match CUID.cly_match_001
animalIdstring| nullOptionalAssociated offspring animal CUID.cly1abc1230001xyz
contactIdstringYesBuyer contact CUID.cly_cnt_001
waitingListIdstring| nullOptionalAssociated waiting list reservation CUID.cly_wl_001
purchasePricenumber| nullOptionalAgreed total purchase price.2500
depositAmountnumber| nullOptionalReservation deposit amount.500
depositPaidbooleanYesWhether reservation deposit has been settled.
fullyPaidbooleanYesWhether the full purchase price has already been paid by the buyer (set at creation; forces the balance due to 0).
paymentLinkUrlstring| nullOptionalOptional https payment URL shown to the buyer as a QR code before signing; payment is verified manually by the breeder.https://pay.example.com/request/abc123
balanceDuenumber| nullOptionalRemaining balance due upon animal handover.2000
currencystringYesThree-letter ISO currency code.EUR
renderedContentstringYesFull contract terms and conditions.<h2>OFFICIAL PURCHASE AGREEMENT</h2>...
sectionsarrayOptionalSnapshot of template sections (title + rendered content) taken at creation; drives PDF section numbering. Empty for flat-content contracts.[{ "title": "Health Guarantee", "content": "<p>...</p>" }]
customFieldsobject[]OptionalSnapshot of the template's buyer fillable field definitions, resolved to the contract's language at creation (flat label/placeholder/description/options, no per-language maps).[{"id":"buyer_address","label":"Adres","type":"TEXT","required":true}]
identificationItemsstring[]OptionalSnapshot of the template's optional identification row keys (CONTRACT_IDENTIFICATION_ITEMS) taken at creation; drives the extra rows the PDF's identification section renders. Fixed rows are implied and not stored.["breederCoc","buyerVat","animalPassport"]
signingTokenstringYesSecure URL token for buyer signing portal.sc_tok_abc123
pdfUrlstring| nullOptionalPublic download URL for sealed PDF document.https://r2.breeder.cloud/contracts/BC-SC-2026-0001.pdf
securityHashstring| nullOptionalSHA-256 cryptographic seal of signed terms and signatures.e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
createdAtstringYesContract creation timestamp.2026-09-08T10:00:00.000Z

ContractTemplate

8 properties

Reusable contract template with dynamic buyer form field definitions.

Field NameTypeRequiredDescriptionSample Value
idstringYesTemplate CUID identifier.cly_tmpl_001
namestringYesTemplate title.Standard Puppy Purchase Agreement
descriptionstring| nullOptionalTemplate description.Standard agreement with health guarantee.
contentstringYesContract text with placeholder tags.<h2>PURCHASE AGREEMENT</h2>...
fieldsobject[]YesBuyer fillable field definitions. Buyer-facing strings (label, placeholder, description, SELECT options) are stored per language in *ByLanguage maps (en/nl); the flat label/placeholder/description/options keys are the legacy single-language fallback. Contract snapshots store the flat form resolved for the contract's language.[{"id":"buyer_address","type":"TEXT","required":true,"labelByLanguage":{"en":"Address","nl":"Adres"}}]
identificationItemsstring[]OptionalOptional identification row keys (from CONTRACT_IDENTIFICATION_ITEMS) enabled for the PDF's first section; fixed rows are implied. Empty renders only the fixed default set.["breederCoc","animalPassport"]
isDefaultbooleanYesWhether this is the default template for new contracts.
createdAtstringYesCreation timestamp.2026-09-08T10:00:00.000Z

AnimalShare

15 properties

Cross-organization animal collaboration and sharing permission record in breeder.cloud.

Field NameTypeRequiredDescriptionSample Value
idstringYesUnique share CUID identifier.cly_share_001
animalIdstringYesCUID of the shared animal.cly1abc1230001xyz
ownerOrganizationIdstring| nullOptionalOwning organization CUID.cly_org_highland
ownerUserIdstringYesOwning user CUID who created the share.usr_123456
targetOrganizationIdstringYesPartner guest organization CUID.cly_org_moonlight
statusstringYesShare status.
Values:PENDINGACCEPTEDDECLINEDREVOKEDEXPIRED
ACCEPTED
accessLevelstringYesBase access level.
Values:READ_ONLYMODIFY
MODIFY
generalAccessstringYesGeneral profile access permission.
Values:NONEREADWRITE
READ
medicalAccessstringYesMedical records access permission.
Values:NONEREADWRITE
READ
matchAccessstringYesMatches and pairings access permission.
Values:NONEREADWRITE
WRITE
waitlistAccessstringYesWaitlist access permission.
Values:NONEREADWRITE
WRITE
combinedWaitlistbooleanYesWhether reservations for this animal are pooled into a unified combined waitlist.
notesstring| nullOptionalOptional collaboration notes.Stud sharing partnership for 2026 spring season.
expiresAtstring| nullOptionalOptional expiration date (ISO 8601).2026-12-31T23:59:59.000Z
createdAtstringYesShare record creation timestamp.2026-09-08T10:00:00.000Z

MatchAnimal

19 properties

Parent or offspring animal summary returned within a breeding match, including nest identification color and full weight record history.

Field NameTypeRequiredDescriptionSample Value
idstringYesUnique CUID identifier of the animal.cly_offspring_001
namestring| nullOptionalCall name of the animal, typically including the nest identification color for offspring.Puppy Blue Collar
nameFullstring| nullOptionalOfficial pedigree or kennel club registered name.null
sexstring| nullOptionalBiological sex of the animal.
Values:femalemaleotherunknown
female
dateOfBirthstring| nullOptionalDate of birth (ISO 8601); derive age on the client side.2026-05-06T00:00:00.000Z
placeOfBirthstring| nullOptionalTwo-letter ISO2 country code where the animal was born.NL
dateOfDeathstring| nullOptionalDate of death if deceased (ISO 8601).null
weightAtBirthnumber| nullOptionalBirth weight in grams.350
coatstring| nullOptionalCoat texture or length type (coat type).Wavy
colorNamestring| nullOptionalCoat color description.Light Golden
raceNamestring| nullOptionalBreed or race name (singular).Golden Retriever
racePluralstring| nullOptionalBreed or race name (plural).Golden Retrievers
sizestring| nullOptionalSize category or measured height.Medium
imagestring| nullOptionalPrimary profile image URL.https://r2.breeder.cloud/animals/bella-profile.webp
excerptstring| nullOptionalShort summary used in cards and public listings.Top-ranked female with complete health test clearance.
descriptionstring| nullOptionalFull bio, temperament description, and accolades.Calm and friendly temperament, excellent retriever instincts.
nestColorstring| nullOptionalNest (collar) identification color: either a palette id from the NestColor enum (e.g. 'blue') or a custom value 'custom:#RRGGBB' (see the 'custom' sentinel in NestColor). Distinct from the coat color.blue
nestColorHexstring| nullOptionalResolved hexadecimal value of the nest identification color (e.g. '#3B82F6'), or null when no nest color is set.#3B82F6
weightRecordsAnimalWeightRecord[]YesFull weigh-in history ordered by timestamp (descending).[{"id":210,"animalId":"cly_offspring_001","weight":350,"timestamp":"2026-05-06T09:00:00.000Z"}]

MatchExternalSire

6 properties

Reusable external sire (father from another breeder) linked to a match, including its registration ID and photo for client websites.

Field NameTypeRequiredDescriptionSample Value
idstringYesUnique CUID identifier of the external sire record.cly_extsire_001
namestringYesName of the external sire.Champion Rocky of Highland
breedstring| nullOptionalBreed of the external sire.Golden Retriever
registrationIdstring| nullOptionalRegistration ID of the external sire, scoped to the association in registrationAssociation when set (only associations with an identification system can be referenced), or a generic registration ID otherwise.GR-2019-48211
photoUrlstring| nullOptionalPublic URL of the photo uploaded specifically for this external sire.https://r2.breeder.cloud/users/usr_123456/external-sires/cly_extsire_001/rocky.webp
registrationAssociationobject| nullOptionalAssociation or certification the registrationId belongs to (id, title, type); null when the registration ID is generic.{"id":"cly_cert_kennel","title":"Dutch Kennel Association","type":"ASSOCIATION"}

Match

18 properties

Breeding match (litter) pairing a mother (Dam) and father (Sire, internal or external) with their registered offspring.

Field NameTypeRequiredDescriptionSample Value
idstringYesUnique CUID identifier of the match.cly_match_001
ownerIdstringYesUser ID of the match owner/breeder.usr_123456
organizationIdstring| nullOptionalOrganization CUID owning the match.cly_org_highland
motherIdstring| nullOptionalCUID of the internal mother (Dam) animal, null when unknown.cly1abc1230001xyz
fatherIdstring| nullOptionalCUID of the internal father (Sire) animal, null for external or unknown sires.cly_sire_001
fatherNamestring| nullOptionalFree-form name of an external father (Sire), used when no internal animal is linked.Highland Duke Oliver
fatherBreedstring| nullOptionalFree-form breed of an external father (Sire).Golden Retriever
externalSireobject| nullYesReusable external sire record (id, name, breed, registrationId, photoUrl, registrationAssociation) when the match references one; null otherwise (see MatchExternalSire).{"id":"cly_extsire_001","name":"Champion Rocky of Highland","breed":"Golden Retriever","registrationId":"GR-2019-48211","photoUrl":"https://r2.breeder.cloud/users/usr_123456/external-sires/cly_extsire_001/rocky.webp","registrationAssociation":{"id":"cly_cert_kennel","title":"Dutch Kennel Association","type":"ASSOCIATION"}}
sireTypestringYesWhether the father is an internal animal or externally referenced free-form details.
Values:INTERNALEXTERNAL
INTERNAL
isTbdbooleanYesWhether the father (Sire) is still to be determined.
notesstring| nullOptionalFree-form breeding notes.Planned spring litter.
matingDatestring| nullOptionalMating or covering date (ISO 8601).2026-03-02T00:00:00.000Z
estimatedDateOfBirthstring| nullOptionalEstimated date of birth derived from the mating date and species gestation (ISO 8601).2026-05-04T00:00:00.000Z
motherobject| nullOptionalInternal mother (Dam) animal summary including nest color, coat, birth weight and weight records (see MatchAnimal).{"id":"cly1abc1230001xyz","name":"Bella","sex":"female","nestColor":"red","nestColorHex":"#EF4444","weightAtBirth":380}
fatherobject| nullOptionalInternal father (Sire) animal summary including nest color, coat, birth weight and weight records (see MatchAnimal); null for external sires.{"id":"cly_sire_001","name":"Maximus","sex":"male","nestColor":null,"nestColorHex":null,"weightAtBirth":420}
animalsMatchAnimal[]YesRegistered offspring of this match ordered by date of birth (ascending), each with name, nest identification color and hex code, date of birth, coat type, coat color, birth weight and full weight record history.[{"id":"cly_offspring_001","name":"Puppy Blue Collar","sex":"female","nestColor":"blue","nestColorHex":"#3B82F6","weightAtBirth":350,"weightRecords":[{"id":210,"weight":350,"timestamp":"2026-05-06T09:00:00.000Z"}]}]
createdAtstringYesMatch creation timestamp.2026-03-01T10:00:00.000Z
updatedAtstringYesLast update timestamp.2026-05-20T09:00:00.000Z

MatchListResponse

4 properties

Standard response envelope returned by the list matches endpoint.

Field NameTypeRequiredDescriptionSample Value
successbooleanYesWhether the request succeeded.
organizationobject| nullOptionalOrganization the matches are scoped to (id, name, slug).{"id":"cly_org_highland","name":"Highland Kennels","slug":"highland-kennels"}
dataMatch[]YesPaginated list of breeding matches with parents and offspring.[{"id":"cly_match_001","sireType":"INTERNAL","isTbd":false,"animals":[{"id":"cly_offspring_001","name":"Puppy Blue Collar","nestColor":"blue","nestColorHex":"#3B82F6"}]}]
paginationobjectYesPagination metadata (total, page, limit, totalPages).{"total":1,"page":1,"limit":20,"totalPages":1}

Enums Catalog & Possible Values

Comprehensive dictionary of all domain enums used across request query filters, body payloads, and response models.

AnimalStatus

4 values
Used in:Animal.statusGET /api/v1/animals?status={status}

Represents the lifecycle and breeding availability status of an animal in breeder.cloud.

Value (Literal)Display LabelMeaning & Usage
ActiefActiveAnimal is currently active and in the main breeding or companion program.
InactiefInactiveAnimal is currently not active in breeding or events, but remains in records.
Toekomstige belofteFuture ProspectYoung animal or prospective candidate planned for future breeding or evaluation.
GepensioneerdRetiredAnimal has concluded its breeding or showing career and is retired.

Sex

4 values
Used in:Animal.sexGET /api/v1/animals?sex={sex}WaitingList.preferenceSex

Biological sex of the animal or preferred offspring sex filter.

Value (Literal)Display LabelMeaning & Usage
VrouwelijkFemaleFemale animal (e.g. Dam, Queen, Mare, Doe, Hen).
MannelijkMaleMale animal (e.g. Sire, Tom, Stallion, Buck, Cock).
AndersOtherNon-binary, neutered, or specialized classification.
Onbekend / Niet ingevuldUnknown / UnassignedSex not yet identified or pending DNA/pedigree verification.

CmsMenuLocation

2 values
Used in:CmsMenu.locationGET /api/v1/organizations/{id}/menus?location={location}

Placement position of navigation menus within public CMS website templates.

Value (Literal)Display LabelMeaning & Usage
HeadernavigatieHeader NavigationPrimary navigation bar rendered in the website header or top drawer.
FooternavigatieFooter NavigationSecondary navigation links rendered at the bottom of website pages.

CmsMenuItemType

3 values
Used in:CmsMenuItem.linkType

Specifies how a menu navigation link is resolved and navigated.

Value (Literal)Display LabelMeaning & Usage
Aangepaste URLCustom URLExternal or arbitrary path provided directly in the URL field.
CMS-paginaCMS PageInternal reference to a published CMS page within the same organization.
Dynamische routeDynamic RoutePre-configured programmatic view such as animals gallery or active dams.

CmsDynamicPage

4 values
Used in:CmsMenuItem.dynamicPage

Target identifier for dynamic automated pages rendered by client websites.

Value (Literal)Display LabelMeaning & Usage
Alle dieren (showcase)All Animals ShowcaseDynamic gallery showing all active animals and pedigree profiles.
Actieve vrouwtjes (moederdieren)Active Dams / FemalesFiltered dynamic view showcasing all active breeding females.
Actieve mannetjes (vaderdieren)Active Sires / MalesFiltered dynamic view showcasing all active breeding males/studs.
NestenoverzichtLitters OverviewLitter planning and announcements overview (/litters).

CmsDynamicRouteType

6 values
Used in:CmsDynamicPageSeo.routeTypeGET /api/v1/organizations/{id}/seo/dynamic-pages

Supported dynamic route types in the breeder.cloud REST API.

Value (Literal)Display LabelMeaning & Usage
DierenoverzichtAnimals OverviewAll animals catalog page (/animals).
Actieve vrouwtjesActive FemalesBreeding females & dams showcase (/animals/females).
Actieve mannetjesActive MalesStud males & sires showcase (/animals/males).
DierenprofielAnimal ProfileIndividual animal profile page (/animals/[id]).
NestenoverzichtLitters OverviewLitter planning and announcements (/litters).
NestdetailsLitter DetailsIndividual litter page with parents (/litters/[id]).

OrganizationCertificationType

2 values
Used in:CmsCertification.typeGET /api/v1/organizations/{id}/certifications?type={type}

Type of breeder badge, kennel club affiliation, or health accreditation.

Value (Literal)Display LabelMeaning & Usage
Certificering / OnderscheidingCertification / AwardAccredited health test certificate, breeder achievement, or official award.
Vereniging / ClubAssociation / ClubKennel club, breed association, registry, or syndicate membership.

CertificationStatus

3 values
Used in:CmsCertification.statusisCertificationExpired()

Calculated expiration status of a certification or license.

Value (Literal)Display LabelMeaning & Usage
Actief / GeldigActive / ValidCertification is currently active and before its expiration date.
VerlopenExpiredCertification expiration date has passed and requires renewal.
Geen vervaldatumNo ExpirationPermanent or lifetime certificate with no renewal requirement.

CmsSectionType

4 values
Used in:CmsSection.type

Layout structure and widget behavior of a CMS page section.

Value (Literal)Display LabelMeaning & Usage
Standaard rastersectieDefault Grid SectionModular multi-column layout containing custom rich text, cards, or images.
Dierenshowcase-rasterAnimal Showcase GridDynamic showcase of organization animals filtered by breed, sex, or status with custom title, subtitle, and description.
Certificeringencarrousel / rasterCertifications Carousel / GridDedicated section showcasing kennel club badges and health testing credentials.
Interactief contactformulierInteractive Contact FormContext-aware inquiry form directly linked to an animal or waiting list.

CmsColumnType

5 values
Used in:CmsColumn.type

Content widget rendered inside a CMS section column.

Value (Literal)Display LabelMeaning & Usage
Rijke tekst / HTMLRich Text / HTMLFormatted WYSIWYG content, headings, paragraphs, and inline links.
Enkele afbeelding / mediaSingle Image / MediaBanner image with alt text, captions, and responsive sizing.
CertificeringsshowcaseCertification ShowcaseRenders an embedded breeder certification badge with verify link.
Aanvraagformulier-widgetInquiry Form WidgetInbound message form with optional animal and waitlist context.
Aangepaste HTML / embedCustom HTML / EmbedRaw embed code, custom script widget, or third-party iframe.

CmsContactSubmissionStatus

4 values
Used in:CmsContactSubmission.statusPATCH /api/v1/organizations/{id}/contact-submissions/{subId}

Processing lifecycle status for inbound contact messages.

Value (Literal)Display LabelMeaning & Usage
OngelezenUnreadNew incoming message awaiting breeder review.
GelezenReadMessage has been viewed by the organization team.
BeantwoordRepliedResponse has been sent to the prospective customer or contact.
GearchiveerdArchivedMessage handled and stored in long-term archive.

ContactType

3 values
Used in:Contact.typeGET /api/contacts

Classification of external parties in the CRM contact directory.

Value (Literal)Display LabelMeaning & Usage
Klant / KoperCustomer / BuyerProspective or past puppy/kitten/offspring purchaser.
Externe fokkerExternal BreederPartner breeder, stud owner, or external kennel.
Algemene contactpersoonGeneral ContactVeterinarian, trainer, supplier, co-owner, or business contact.

WaitingListStatus

5 values
Used in:WaitingList.status

Reservation pipeline status for prospective puppy/kitten buyers.

Value (Literal)Display LabelMeaning & Usage
WachtendWaitingBuyer is on the active waiting list awaiting an appropriate match.
Toegewezen aan koppelingAssigned to PairingBuyer is allocated to a specific planned mating or pregnant dam.
Toegewezen aan specifiek nageslachtAllocated Specific OffspringA specific puppy/kitten in a born litter has been assigned to this buyer.
VoltooidCompletedTransfer of offspring completed successfully.
Geannuleerd / TerugbetaaldCancelled / RefundedReservation withdrawn or deposit refunded.

MedicalTestCategory

8 values
Used in:MedicalTest.categoryAnimalMedicalRecord.category

Clinical health examination and diagnostic categorization.

Value (Literal)Display LabelMeaning & Usage
Algemene gezondheidGeneral HealthRoutine checkups, vaccination records, and physical examinations.
Genetica & DNA-panelenGenetic & DNA PanelsInherited disease screenings, DNA test panels, and color genetics.
Orthopedie & gewrichtenOrthopedics & JointsHip dysplasia (HD), Elbow dysplasia (ED), and Patella luxation scores.
Oogheelkunde / ECVOOphthalmology / ECVOEye examinations, PRA screenings, and cataract evaluations.
CardiologieCardiologyHeart auscultation, ECG, and echocardiography screenings.
TandheelkundeDentistryBite evaluation, dentition counts, and oral health.
ReproductieReproductionSemen analysis, progesterone tests, ultrasound, and fertility reports.
Overige gezondheidsonderzoekenOther Health DiagnosticsSpecialized lab tests, allergy testing, and neurological screens.

AnimalCategory

9 values
Used in:AnimalPreset.animalCategory

Broad species classification for biological presets and templates.

Value (Literal)Display LabelMeaning & Usage
HondCanine / DogDogs, puppies, stud dogs, and dams.
KatFeline / CatCats, kittens, studs, and queens.
PaardEquine / HorseHorses, foals, stallions, and mares.
VogelAvian / BirdParrots, raptors, poultry, and waterfowl.
KonijnRabbitRabbits, kits, bucks, and does.
GeitCaprine / GoatGoats, kids, bucks, and does.
SchaapOvine / SheepSheep, lambs, rams, and ewes.
ReptielReptileSnakes, lizards, geckos, and turtles.
Andere diersoortOther SpeciesOther domesticated or exotic species.

AnimalSortBy

7 values
Used in:GET /api/v1/animals?sortBy={sortBy}

Allowed sorting fields for animal list queries.

Value (Literal)Display LabelMeaning & Usage
AanmaakdatumCreated DateOrder by date added to breeder.cloud.
RoepnaamCall NameOrder alphabetically by animal call name.
GeboortedatumBirth DateOrder chronologically by birth date.
Laatst bijgewerktLast UpdatedOrder by last modification timestamp.
StatusStatusOrder by lifecycle status (ACTIVE, INACTIVE, etc.).
RasBreed / RaceOrder alphabetically by race or breed name.
GeslachtSexOrder by sex classification.

SortOrder

2 values
Used in:GET /api/v1/animals?sortOrder={sortOrder}

Direction for sorting query results.

Value (Literal)Display LabelMeaning & Usage
OplopendAscendingLowest or earliest first (A-Z, 0-9, oldest to newest).
AflopendDescendingHighest or newest first (Z-A, 9-0, newest to oldest).

Role

2 values
Used in:User.role

System user access role in breeder.cloud.

Value (Literal)Display LabelMeaning & Usage
StandaardgebruikerStandard UserStandard breeder or kennel manager.
BeheerderAdministratorPlatform administrator with system-wide permissions.

Subscription

3 values
Used in:User.subscription

Platform tier subscription level.

Value (Literal)Display LabelMeaning & Usage
Gratis abonnementFree TierBasic kennel management with starter limits.
Plus-abonnementPlus TierAdvanced breeding management and automated matches.
Premium-abonnementPremium TierUnlimited animals, AI presets, and full CMS website hosting.

ContractStatus

6 values
Used in:SalesContract.statusGET /api/v1/contracts?status={status}

Lifecycle status of a sales contract or purchase agreement.

Value (Literal)Display LabelMeaning & Usage
ConceptDraftContract draft created and editable by breeder.
Verzonden / in afwachting van handtekeningSent / Pending SignatureContract sent to buyer awaiting review and signature.
Bekeken door koperViewed by BuyerBuyer has opened the signing link.
OndertekendExecuted / SignedBoth parties have completed and signed the agreement.
Ingetrokken / geannuleerdVoided / CancelledContract has been voided by the breeder.
VerlopenExpiredSigning token deadline has lapsed.

ContractFieldType

6 values
Used in:ContractTemplate.fieldsSalesContract.customFields

Input field type for dynamic buyer form fields in contract templates.

Value (Literal)Display LabelMeaning & Usage
Tekst (één regel)Single-line TextStandard single line text input (address, phone, name).
Tekst (meerdere regels)Multi-line TextMulti-line text area for notes or extended descriptions.
Selectievakje / bevestigingCheckbox / AcknowledgmentBoolean agreement or consent toggle.
DatumkiezerDate PickerCalendar date selection.
VervolgkeuzelijstDropdown SelectSingle selection from a list of predefined options.
Digitale handtekeningDigital SignatureElectronic canvas signature pad.

AnimalShareStatus

5 values
Used in:AnimalShare.status

Status of a cross-organization animal sharing invitation or active collaboration in breeder.cloud.

Value (Literal)Display LabelMeaning & Usage
In afwachtingPendingInvitation sent and awaiting response from the partner organization.
GeaccepteerdAcceptedShare invitation accepted; partner organization has active access.
GeweigerdDeclinedTarget organization declined the sharing invitation.
IngetrokkenRevokedAccess has been revoked by either owning or partner organization.
VerlopenExpiredTemporary sharing timeframe has lapsed.

AnimalShareAccessLevel

2 values
Used in:AnimalShare.accessLevel

Base access tier granted to the partner organization.

Value (Literal)Display LabelMeaning & Usage
Alleen lezenRead-OnlyPartner organization can view granted domain scopes.
WijzigenModifyPartner organization can view and edit granted domain scopes.

AnimalSharePermission

3 values
Used in:AnimalShare.generalAccessAnimalShare.medicalAccessAnimalShare.matchAccessAnimalShare.waitlistAccess

Granular scope permission for specific animal modules.

Value (Literal)Display LabelMeaning & Usage
Geen toegangNo AccessModule is completely hidden from the partner organization.
LeestoegangRead AccessPartner organization can view records within this module.
SchrijftoegangWrite AccessPartner organization can view, create, and edit records within this module.

NestColor

25 values
Used in:MatchAnimal.nestColorMatchAnimal.nestColorHex

Nest (collar) identification colour palette for offspring, with English and Dutch labels per value. Values are palette ids; the trailing 'custom' sentinel represents any free-form colour stored as 'custom:#RRGGBB'. English and Dutch labels are provided for each value.

Value (Literal)Display LabelMeaning & Usage
RoodRedNest (collar) identification colour swatch: Red (#EF4444). Distinct from the coat colour.
OranjeOrangeNest (collar) identification colour swatch: Orange (#F97316). Distinct from the coat colour.
AmberAmberNest (collar) identification colour swatch: Amber (#F59E0B). Distinct from the coat colour.
GeelYellowNest (collar) identification colour swatch: Yellow (#EAB308). Distinct from the coat colour.
LimoengroenLimeNest (collar) identification colour swatch: Lime (#84CC16). Distinct from the coat colour.
GroenGreenNest (collar) identification colour swatch: Green (#22C55E). Distinct from the coat colour.
SmaragdgroenEmeraldNest (collar) identification colour swatch: Emerald (#10B981). Distinct from the coat colour.
OlijfgroenOliveNest (collar) identification colour swatch: Olive (#4D7C0F). Distinct from the coat colour.
BruinBrownNest (collar) identification colour swatch: Brown (#78350F). Distinct from the coat colour.
BronsBronzeNest (collar) identification colour swatch: Bronze (#B45309). Distinct from the coat colour.
MintMintNest (collar) identification colour swatch: Mint (#6EE7B7). Distinct from the coat colour.
TurquoiseTurquoiseNest (collar) identification colour swatch: Turquoise (#2DD4BF). Distinct from the coat colour.
AppelblauwzeegroenTealNest (collar) identification colour swatch: Teal (#14B8A6). Distinct from the coat colour.
CyaanCyanNest (collar) identification colour swatch: Cyan (#06B6D4). Distinct from the coat colour.
HemelsblauwSkyNest (collar) identification colour swatch: Sky (#0EA5E9). Distinct from the coat colour.
BlauwBlueNest (collar) identification colour swatch: Blue (#3B82F6). Distinct from the coat colour.
IndigoIndigoNest (collar) identification colour swatch: Indigo (#6366F1). Distinct from the coat colour.
VioletVioletNest (collar) identification colour swatch: Violet (#8B5CF6). Distinct from the coat colour.
PaarsPurpleNest (collar) identification colour swatch: Purple (#A855F7). Distinct from the coat colour.
RozePinkNest (collar) identification colour swatch: Pink (#EC4899). Distinct from the coat colour.
BeigeBeigeNest (collar) identification colour swatch: Beige (#D6D3D1). Distinct from the coat colour.
GrijsGrayNest (collar) identification colour swatch: Gray (#78716C). Distinct from the coat colour.
WitWhiteNest (collar) identification colour swatch: White (#FFFFFF). Distinct from the coat colour.
ZwartBlackNest (collar) identification colour swatch: Black (#1E293B). Distinct from the coat colour.
AangepastCustomCustom free-form colour. Stored and returned as 'custom:#RRGGBB' (e.g. 'custom:#7C3AED'); the resolved hex value is also exposed as MatchAnimal.nestColorHex. Any valid 3- or 6-digit hex is accepted, so 'custom' here is a sentinel rather than a literal value.

Machine-Readable API Specification Endpoints

The breeder.cloud REST API exposes machine-readable specifications over HTTP so client websites, SDK generators, and API client tools can automatically discover endpoints, schemas, and enums.

OpenAPI 3.1.0Open JSON

GET /api/v1/openapi.json

Standard OpenAPI 3.1.0 JSON format. Compatible with Swagger Editor, Postman Collection Import, OpenAPI TypeScript Codegen, and Orval.

BASH
curl -X GET "https://breeder.cloud/api/v1/openapi.json"
Comprehensive Spec JSONOpen JSON

GET /api/v1/spec

Rich structured JSON specification including endpoints array, schemas dictionary, and full enums catalog with value descriptions.

BASH
curl -X GET "https://breeder.cloud/api/v1/spec"