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.
# 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"{
"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.
https://breeder.cloudRetrieve 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
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| organizationId | query | string | No | Organization ID or slug to scope animal query (requires Admin/Owner rights on the organization). |
| scope | query | string | No | Scope of animals to retrieve (owned only, shared with organization only, or all accessible). Allowed: ownedsharedallDefault: owned |
| page | query | integer | No | Page number (1-based). Default: 1 |
| limit | query | integer | No | Maximum number of animals per page (1 to 100). Default: 20 |
| search | query | string | No | Filter by animal name, full name, registration number, association ID, or microchip. |
| associationId | query | string | No | Filter animals by association identification number or external parent association ID. |
| sex | query | string | No | Filter by biological sex. Allowed: femalemaleotherunknown |
| status | query | string | No | Filter by animal status. Allowed: ACTIVEINACTIVEFUTURERETIRED |
| archived | query | boolean | No | Include archived animals if true. Default: false |
| forBreeding | query | boolean | No | Filter animals intended for breeding program. |
| raceName | query | string | No | Filter by specific singular breed or race name (supports alias 'breed'). |
| racePlural | query | string | No | Filter by specific plural breed or race name (supports alias 'breedPlural'). |
| colorName | query | string | No | Filter by color pattern. |
| sortBy | query | string | No | Field to sort by. Allowed: namedateOfBirthcreatedAtupdatedAtstatusraceNamesexDefault: createdAt |
| sortOrder | query | string | No | Sort direction. Allowed: ascdescDefault: desc |
| lang | query | string | No | Language code for localized medical tests (e.g. 'en', 'nl'). |
Response Formats
{
"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
}
}Integration Code Examples
curl -X GET "https://breeder.cloud/api/v1/animals?status=ACTIVE&limit=10" \
-H "Authorization: Bearer bc_live_your_token_here"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
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | Yes | Organization ID or slug. |
Response Formats
{
"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"
]
}
}
}Integration Code Examples
curl -X GET "https://breeder.cloud/api/v1/organizations/highland-kennels/template" \
-H "Authorization: Bearer bc_live_your_token_here"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 propertiesCore pedigree and animal record representing an individual animal in breeder.cloud.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Unique CUID identifier of the animal. | cly1abc1230001xyz |
| ownerId | string | Yes | User ID of the animal owner/breeder. | usr_123456 |
| presetId | string| null | Optional | Associated biological species/breed preset ID. | cly_preset_dog |
| name | string| null | Optional | Official call name of the animal. | Bella |
| nameFull | string| null | Optional | Official pedigree or kennel club registered name. | Bella of Highland Kennels |
| dateOfBirth | string| null | Optional | Date of birth (ISO 8601). | 2023-04-12T00:00:00.000Z |
| dateOfDeath | string| null | Optional | Date of death if deceased (ISO 8601). | null |
| placeOfBirth | string| null | Optional | Two-letter ISO2 country code where the animal was born. | NL |
| weightAtBirth | number| null | Optional | Birth weight in grams. | 380 |
| sex | string| null | Optional | Biological sex of the animal. Values: femalemaleotherunknown | female |
| colorName | string| null | Optional | Coat or plumage color description. | Golden Sable |
| raceName | string| null | Optional | Breed or race name (singular). | Golden Retriever |
| racePlural | string| null | Optional | Breed or race name (plural). | Golden Retrievers |
| preset | object| null | Optional | Associated 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"} |
| dnaProfile | string| null | Optional | ISAG / DNA identification profile code. | DNA-ISAG-2024-8849 |
| colorDna | string| null | Optional | Coat color genetics genotype string. | e/e B/B D/D ky/ky ay/a |
| size | string| null | Optional | Size category or measured height. | Medium (54 cm) |
| coat | string| null | Optional | Coat texture or length type. | Long / Dense |
| status | string | Yes | Breeding and lifecycle status. Values: ACTIVEINACTIVEFUTURERETIRED | ACTIVE |
| breeder | string| null | Optional | Breeder or kennel name of origin. | Highland Kennels |
| passportId | string| null | Optional | Pet passport or official veterinary document number. | NL-2023-88124 |
| registrationId | string| null | Optional | Kennel club / studbook registration number. | NHSB-3289104 |
| microchipId | string| null | Optional | 15-digit ISO 11784/11785 electronic microchip number. | 528140000123456 |
| forBreeding | boolean| null | Optional | Whether the animal is approved or intended for active breeding. | |
| archived | boolean | Yes | Whether the animal has been archived from active listings. | |
| image | string| null | Optional | Primary profile image URL. | https://r2.breeder.cloud/animals/bella-profile.webp |
| description | string| null | Optional | Full bio, temperament description, and accolades. | Calm and friendly temperament, excellent retriever instincts. |
| excerpt | string| null | Optional | Short summary used in cards and public listings. | Top-ranked female with complete health test clearance. |
| motherId | string| null | Optional | ID of the biological mother (Dam). | cly_dam_001 |
| motherName | string| null | Optional | Name of the external mother (Dam). | Highland Princess Luna |
| motherBreed | string| null | Optional | Breed of the external mother (Dam). | Golden Retriever |
| motherAssociationId | string| null | Optional | Association / registration ID of external mother (Dam). | NHSB-3109281 |
| fatherId | string| null | Optional | ID of the biological father (Sire). | cly_sire_001 |
| fatherName | string| null | Optional | Name of the external father (Sire). | Highland Duke Oliver |
| fatherBreed | string| null | Optional | Breed of the external father (Sire). | Golden Retriever |
| fatherAssociationId | string| null | Optional | Association / registration ID of external father (Sire). | NHSB-2984712 |
| certificationNumbers | AnimalCertificationNumber[] | Optional | Official 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}}] |
| createdAt | string | Yes | Record creation timestamp. | 2024-01-10T12:00:00.000Z |
| updatedAt | string | Yes | Record last update timestamp. | 2024-04-15T09:30:00.000Z |
Organization
40 propertiesBreeder kennel, cattery, or stud organization entity hosting CMS websites.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Organization CUID identifier. | cly_org_highland |
| name | string | Yes | Official business or kennel name. | Highland Kennels |
| slug | string | Yes | Unique URL slug for public routing. | highland-kennels |
| logo | string| null | Optional | Logo image URL. | https://r2.breeder.cloud/logos/highland.webp |
| string| null | Optional | Contact email address. | contact@highlandkennels.com | |
| showEmail | boolean | Optional | Whether to show email on public site. | |
| phone | string| null | Optional | Contact phone number. | +31 6 12345678 |
| showPhone | boolean | Optional | Whether to show phone on public site. | |
| address | string| null | Optional | Physical street address. | Dorpsstraat 42 |
| addressOptional | string| null | Optional | Optional address line 2 / suite / building number. | Suite 4B |
| city | string| null | Optional | City or municipality. | Utrecht |
| zipCode | string| null | Optional | Postal code. | 3511 AA |
| country | string| null | Optional | Two-letter ISO2 country code. | NL |
| showAddress | boolean | Optional | Whether to display address publicly. | |
| cocId | string| null | Optional | Chamber of Commerce / KvK registration number. | 88392014 |
| showCocId | boolean | Optional | Whether to display Chamber of Commerce / KvK registration publicly. | |
| vatId | string| null | Optional | Value Added Tax (VAT) / BTW number. | NL88392014B01 |
| showVatId | boolean | Optional | Whether to display VAT / BTW number publicly. | |
| ubn | string| null | Optional | Unique Business Number (UBN), the Dutch livestock farm registration number. | 54321 |
| showUbn | boolean | Optional | Whether to display the Unique Business Number (UBN) publicly. | |
| website | string| null | Optional | Custom domain or main website URL. | https://highlandkennels.com |
| showWebsite | boolean | Optional | Whether to display website link publicly. | |
| string| null | Optional | Facebook page URL. | https://facebook.com/highlandkennels | |
| showFacebook | boolean | Optional | Whether to display Facebook link publicly. | |
| string| null | Optional | Instagram handle or URL. | https://instagram.com/highlandkennels | |
| showInstagram | boolean | Optional | Whether to display Instagram link publicly. | |
| youtube | string| null | Optional | YouTube channel URL. | https://youtube.com/@highlandkennels |
| showYoutube | boolean | Optional | Whether to display YouTube channel publicly. | |
| tiktok | string| null | Optional | TikTok profile URL. | https://tiktok.com/@highlandkennels |
| showTiktok | boolean | Optional | Whether to display TikTok profile publicly. | |
| xTwitter | string| null | Optional | X / Twitter profile URL. | https://x.com/highlandkennels |
| showXTwitter | boolean | Optional | Whether to display X / Twitter profile publicly. | |
| string| null | Optional | Pinterest profile URL. | https://pinterest.com/highlandkennels | |
| showPinterest | boolean | Optional | Whether to display Pinterest profile publicly. | |
| string| null | Optional | LinkedIn company / profile URL. | https://linkedin.com/company/highlandkennels | |
| showLinkedin | boolean | Optional | Whether to display LinkedIn profile publicly. | |
| webhookUrl | string| null | Optional | Configured cache invalidation webhook URL. | https://highlandkennels.com/api/revalidate |
| webhookSecret | string| null | Optional | Secret used to HMAC-sign cache invalidation webhook payloads. | whsec_live_9a8b7c6d5e4f3a2b |
| webhookEnabled | boolean | Optional | Whether webhook delivery is enabled. | |
| createdAt | string | Yes | Creation date. | 2024-01-01T00:00:00.000Z |
CmsTemplate
80 propertiesDesign system configuration, color palette, typography, favicon, and layout settings for the public website.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Template configuration CUID. | tmpl_123 |
| organizationId | string | Yes | Associated organization ID. | cly_org_highland |
| name | string | Optional | Template profile or theme name. | Default Template |
| favicon | string| null | Optional | Custom favicon URL displayed in browser tabs and bookmarks. | https://r2.breeder.cloud/favicons/kennel-icon.png |
| faviconColorMode | string| null | Optional | Favicon color mode: theme (primary color) or custom. | theme |
| faviconCustomColor | string| null | Optional | Custom hex color used when faviconColorMode is custom. | #2563eb |
| faviconBackground | string| null | Optional | Optional hex background color behind the favicon icon. | #ffffff |
| faviconShape | string| null | Optional | Favicon background shape: square, rounded, or circle. | circle |
| faviconIco | string| null | Optional | Generated multi-size favicon.ico URL. | https://r2.breeder.cloud/cms/org/favicon/favicon.ico |
| favicon16 | string| null | Optional | Generated 16x16 PNG favicon URL. | https://r2.breeder.cloud/cms/org/favicon/favicon-16x16.png |
| favicon32 | string| null | Optional | Generated 32x32 PNG favicon URL. | https://r2.breeder.cloud/cms/org/favicon/favicon-32x32.png |
| favicon96 | string| null | Optional | Generated 96x96 PNG favicon URL. | https://r2.breeder.cloud/cms/org/favicon/favicon-96x96.png |
| faviconAppleTouch | string| null | Optional | Generated 180x180 Apple touch icon URL. | https://r2.breeder.cloud/cms/org/favicon/apple-touch-icon.png |
| faviconIcon192 | string| null | Optional | Generated 192x192 Android/Chrome icon URL. | https://r2.breeder.cloud/cms/org/favicon/icon-192.png |
| faviconIcon512 | string| null | Optional | Generated 512x512 Android/Chrome icon URL. | https://r2.breeder.cloud/cms/org/favicon/icon-512.png |
| faviconManifest | string| null | Optional | Generated site.webmanifest URL. | https://r2.breeder.cloud/cms/org/favicon/site.webmanifest |
| theme | string | Optional | Visual base theme (e.g., modern, classic, minimal, warm). | modern |
| primaryColor | string | Yes | Hex / Tailwind primary accent color. | emerald-600 |
| secondaryColor | string | Yes | Hex / Tailwind secondary complementary color. | slate-600 |
| accentColor | string | Optional | Accent highlight color. | amber-500 |
| backgroundColor | string| null | Optional | Custom background color code. | slate-50 |
| textColor | string| null | Optional | Custom base text color code. | slate-900 |
| mutedColor | string | Optional | Muted surface background color. | slate-100 |
| borderColor | string | Optional | Border and divider color. | slate-200 |
| navbarColor | string | Optional | Navbar / header background color. | white |
| footerColor | string | Optional | Footer background color. | slate-900 |
| fontFamily | string | Yes | Body text font family. | Inter, sans-serif |
| borderRadius | string | Optional | Border radius style for UI elements (none, sm, md, lg, xl, full). | md |
| customColors | object| null | Optional | Custom color overrides JSON object. | null |
| headingFontFamily | string| null | Optional | Heading font family. | Playfair Display, serif |
| headingFont | string | Optional | Primary heading font family. | Playfair Display |
| bodyFont | string | Optional | Base body text font family. | Inter |
| h1Font | string| null | Optional | Specific font for H1 headings. | null |
| h2Font | string| null | Optional | Specific font for H2 headings. | null |
| h3Font | string| null | Optional | Specific font for H3 headings. | null |
| h4Font | string| null | Optional | Specific font for H4 headings. | null |
| h5Font | string| null | Optional | Specific font for H5 headings. | null |
| h6Font | string| null | Optional | Specific font for H6 headings. | null |
| quoteFont | string| null | Optional | Specific font for blockquotes. | null |
| customFonts | object| null | Optional | Custom font overrides JSON object. | null |
| fontCssUrl | string| null | Optional | Self-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 |
| fontCssVersion | string| null | Optional | Cache-busting token for the self-hosted font stylesheet. | 1700000000000 |
| fontsHostedAt | string| null | Optional | When the fonts were last uploaded to our CDN. Null if never synced. | 2024-01-01T00:00:00.000Z |
| h1Color | string | Optional | H1 heading text color. | slate-900 |
| h2Color | string | Optional | H2 heading text color. | slate-900 |
| h3Color | string | Optional | H3 heading text color. | slate-900 |
| h4Color | string | Optional | H4 heading text color. | slate-800 |
| h5Color | string | Optional | H5 heading text color. | slate-800 |
| h6Color | string | Optional | H6 heading text color. | slate-700 |
| bodyTextColor | string | Optional | Body paragraph text color. | slate-700 |
| mutedTextColor | string | Optional | Muted text color. | slate-500 |
| linkTextColor | string | Optional | Hyperlink text color. | blue-600 |
| linkHoverColor | string | Optional | Hyperlink hover state color. | blue-700 |
| captionTextColor | string | Optional | Caption and small helper text color. | slate-400 |
| customTextColors | object| null | Optional | Custom text color overrides JSON object. | null |
| headerTextColor | string | Optional | Header text color. | slate-900 |
| headerLinkColor | string | Optional | Header link color. | blue-600 |
| headerLinkHoverColor | string | Optional | Header link hover color. | blue-700 |
| headerMutedColor | string | Optional | Header muted / secondary text color. | slate-500 |
| headerBorderColor | string | Optional | Header border color. | slate-200 |
| footerTextColor | string | Optional | Footer body text color. | slate-300 |
| footerHeadingColor | string | Optional | Footer section heading color. | white |
| footerLinkColor | string | Optional | Footer link color. | slate-300 |
| footerLinkHoverColor | string | Optional | Footer link hover color. | white |
| footerMutedColor | string | Optional | Footer muted / copyright text color. | slate-400 |
| footerBorderColor | string | Optional | Footer border and divider color. | slate-800 |
| headerStyle | string | Optional | Header navigation style (simple, transparent, centered). | sticky |
| footerStyle | string | Optional | Footer layout style. | columns |
| customCss | string| null | Optional | Custom CSS stylesheet overrides. | null |
| defaultLanguage | string | Yes | Default fallback locale code. | en |
| supportedLanguages | string[] | Yes | List of enabled locale codes. | ["en","nl"] |
| defaultBreed | string| null | Optional | Default singular animal breed name. | Golden Retriever |
| defaultBreedPlural | string| null | Optional | Default plural animal breed name. | Golden Retrievers |
| defaultPresetId | string| null | Optional | Linked default species/breed preset CUID. | cly_preset_dog |
| defaultPreset | object| null | Optional | Linked default species/breed preset object. | {"id":"cly_preset_dog","name":"Golden Retriever","namePlural":"Golden Retrievers","breed":"Golden Retriever","breedPlural":"Golden Retrievers"} |
| resolvedColors | object | Optional | Resolved CSS color variables and computed palettes. | {"primary":{"hex":"#059669","rgb":"5 150 105","className":"bg-emerald-600"}} |
| resolvedTextColors | object | Optional | Resolved CSS text color variables. | {"h1":{"hex":"#064e3b","rgb":"6 78 59","className":"text-emerald-900"}} |
| resolvedGoogleFonts | object | Optional | Resolved 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} |
| createdAt | string | Optional | Creation timestamp. | 2024-01-01T00:00:00.000Z |
| updatedAt | string | Optional | Last update timestamp. | 2024-01-01T00:00:00.000Z |
CmsMarketingSettings
33 propertiesMarketing 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 Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Marketing settings CUID. | mkt_123 |
| organizationId | string | Yes | Associated organization ID. | cly_org_highland |
| ga4MeasurementId | string| null | Optional | Google Analytics 4 measurement ID. Requires cookie consent before loading. | G-ABC123DEF |
| gtmContainerId | string| null | Optional | Google Tag Manager container ID. Requires cookie consent before loading. | GTM-ABC123 |
| googleAdsId | string| null | Optional | Google Ads conversion ID. Requires cookie consent before loading. | AW-123456789 |
| googleAdsLabel | string| null | Optional | Google Ads conversion label. | AbC-D_efGhIjKlMn |
| metaPixelId | string| null | Optional | Meta (Facebook) pixel ID, 15-16 digits. Requires cookie consent before loading. | 123456789012345 |
| cookieConsentEnabled | boolean | Yes | Whether the cookie consent banner is shown. Must be true before analytics or advertising cookies may be set. | |
| consentModeV2 | boolean | Yes | Whether Google Consent Mode v2 is used, keeping analytics denied until the visitor accepts. | |
| consentTitle | string| null | Optional | Banner title text. | We use cookies |
| consentMessage | string| null | Optional | Banner body text. | We use cookies to measure website traffic. |
| consentAcceptLabel | string| null | Optional | Accept button label. | Accept |
| consentDeclineLabel | string| null | Optional | Reject button label. | Reject |
| consentPosition | string | Yes | Banner position: bottom, bottom-left, bottom-right, top or center. | bottom |
| consentLayout | string | Yes | Banner layout: bar (full width) or card (floating). | bar |
| consentTheme | string | Yes | Banner theme: light, dark or template (match website colors). | light |
| consentShowDecline | boolean | Yes | Whether a reject button is shown. Required for GDPR compliance. | |
| whatsappEnabled | boolean | Yes | Whether the floating WhatsApp button is shown. | |
| whatsappNumber | string| null | Optional | WhatsApp number in international format, digits only (E.164 without +). | 31612345678 |
| whatsappMessage | string| null | Optional | Pre-filled chat message. | Hi! I have a question about your puppies. |
| whatsappPosition | string | Yes | Button position: bottom-left or bottom-right. | bottom-right |
| newsletterEnabled | boolean | Yes | Whether newsletter signup is enabled. Add a NEWSLETTER section to a page to place the form. | |
| newsletterProvider | string| null | Optional | Newsletter provider: mailchimp, brevo, mailerlite or custom. | mailchimp |
| newsletterActionUrl | string| null | Optional | Form action URL for the custom provider. | https://mailchi.mp/xxxx/subscribe |
| newsletterTitle | string| null | Optional | Newsletter heading. | Stay updated |
| newsletterDescription | string| null | Optional | Newsletter description. | Get notified about new litters. |
| newsletterButtonLabel | string| null | Optional | Newsletter submit button label. | Subscribe |
| ogDefaultImage | string| null | Optional | Fallback Open Graph share image used when a page defines none. | https://r2.breeder.cloud/cms/org_1/og-default.jpg |
| conversionGoals | object[]| null | Optional | GA4 conversion events. Each item: { id?, eventName, trigger, label, enabled }. | [{"eventName":"generate_lead","trigger":"CONTACT_FORM_SUBMIT","label":"Puppy inquiry","enabled":true}] |
| consentMissingTags | string[] | Optional | Tracking tag fields that are set but not covered by the consent banner (ga4MeasurementId, gtmContainerId, googleAdsId, metaPixelId). Empty when compliant. | [] |
| scripts | object | Optional | Ready-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"}} |
| createdAt | string | Optional | Creation timestamp. | 2024-01-01T00:00:00.000Z |
| updatedAt | string | Optional | Last update timestamp. | 2024-01-01T00:00:00.000Z |
CmsTemplateInput
61 propertiesInput payload for creating or updating website design system template, favicon, typography, and color tokens.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| name | string | Optional | Template profile or theme name. | Default Template |
| favicon | string| null | Optional | Custom favicon URL displayed in browser tabs and bookmarks. | https://r2.breeder.cloud/favicons/kennel-icon.png |
| faviconColorMode | string| null | Optional | Favicon color mode: theme (primary color) or custom. | theme |
| faviconCustomColor | string| null | Optional | Custom hex color used when faviconColorMode is custom. | #2563eb |
| faviconBackground | string| null | Optional | Optional hex background color behind the favicon icon. | #ffffff |
| faviconShape | string| null | Optional | Favicon background shape: square, rounded, or circle. | circle |
| theme | string | Optional | Visual base theme preset. | modern |
| primaryColor | string | Optional | Hex / Tailwind primary accent color. | emerald-600 |
| secondaryColor | string | Optional | Hex / Tailwind secondary complementary color. | slate-600 |
| accentColor | string | Optional | Accent highlight color. | amber-500 |
| backgroundColor | string| null | Optional | Custom background color code. | slate-50 |
| textColor | string| null | Optional | Custom base text color code. | slate-900 |
| mutedColor | string | Optional | Muted surface background color. | slate-100 |
| borderColor | string | Optional | Border and divider color. | slate-200 |
| navbarColor | string | Optional | Navbar / header background color. | white |
| footerColor | string | Optional | Footer background color. | slate-900 |
| fontFamily | string | Optional | Body text font family. | Inter, sans-serif |
| borderRadius | string | Optional | Border radius style for UI elements. | md |
| customColors | object| null | Optional | Custom color overrides JSON object. | null |
| headingFontFamily | string| null | Optional | Heading font family. | Playfair Display, serif |
| headingFont | string | Optional | Primary heading font family. | Playfair Display |
| bodyFont | string | Optional | Base body text font family. | Inter |
| h1Font | string| null | Optional | Specific font for H1 headings. | null |
| h2Font | string| null | Optional | Specific font for H2 headings. | null |
| h3Font | string| null | Optional | Specific font for H3 headings. | null |
| h4Font | string| null | Optional | Specific font for H4 headings. | null |
| h5Font | string| null | Optional | Specific font for H5 headings. | null |
| h6Font | string| null | Optional | Specific font for H6 headings. | null |
| quoteFont | string| null | Optional | Specific font for blockquotes. | null |
| customFonts | object| null | Optional | Custom font overrides JSON object. | null |
| h1Color | string | Optional | H1 heading text color. | slate-900 |
| h2Color | string | Optional | H2 heading text color. | slate-900 |
| h3Color | string | Optional | H3 heading text color. | slate-900 |
| h4Color | string | Optional | H4 heading text color. | slate-800 |
| h5Color | string | Optional | H5 heading text color. | slate-800 |
| h6Color | string | Optional | H6 heading text color. | slate-700 |
| bodyTextColor | string | Optional | Body paragraph text color. | slate-700 |
| mutedTextColor | string | Optional | Muted text color. | slate-500 |
| linkTextColor | string | Optional | Hyperlink text color. | blue-600 |
| linkHoverColor | string | Optional | Hyperlink hover state color. | blue-700 |
| captionTextColor | string | Optional | Caption and small helper text color. | slate-400 |
| customTextColors | object| null | Optional | Custom text color overrides JSON object. | null |
| headerTextColor | string | Optional | Header text color. | slate-900 |
| headerLinkColor | string | Optional | Header link color. | blue-600 |
| headerLinkHoverColor | string | Optional | Header link hover color. | blue-700 |
| headerMutedColor | string | Optional | Header muted / secondary text color. | slate-500 |
| headerBorderColor | string | Optional | Header border color. | slate-200 |
| footerTextColor | string | Optional | Footer body text color. | slate-300 |
| footerHeadingColor | string | Optional | Footer section heading color. | white |
| footerLinkColor | string | Optional | Footer link color. | slate-300 |
| footerLinkHoverColor | string | Optional | Footer link hover color. | white |
| footerMutedColor | string | Optional | Footer muted / copyright text color. | slate-400 |
| footerBorderColor | string | Optional | Footer border and divider color. | slate-800 |
| headerStyle | string | Optional | Header navigation style. | sticky |
| footerStyle | string | Optional | Footer layout style. | columns |
| customCss | string| null | Optional | Custom CSS stylesheet overrides. | null |
| defaultLanguage | string | Optional | Default fallback locale code. | en |
| supportedLanguages | string[] | Optional | List of enabled locale codes. | ["en","nl"] |
| defaultBreed | string| null | Optional | Default singular animal breed name. | Golden Retriever |
| defaultBreedPlural | string| null | Optional | Default plural animal breed name. | Golden Retrievers |
| defaultPresetId | string| null | Optional | Linked default species/breed preset CUID. | cly_preset_dog |
AnimalPreset
16 propertiesBiological species and breed preset template defining singular and plural terminology.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Preset CUID identifier. | cly_preset_dog |
| name | string | Yes | Singular breed or preset name. | Golden Retriever |
| namePlural | string| null | Optional | Plural breed or preset name. | Golden Retrievers |
| breed | string| null | Optional | Singular breed name. | Golden Retriever |
| breedPlural | string| null | Optional | Plural breed name. | Golden Retrievers |
| race | string| null | Optional | Singular race or breed name. | Golden Retriever |
| racePlural | string| null | Optional | Plural race or breed name. | Golden Retrievers |
| animal | string | Yes | Singular animal species name. | Dog |
| animalPlural | string | Yes | Plural animal species name. | Dogs |
| femaleName | string | Yes | Singular female animal name. | Dam |
| femaleNamePlural | string | Yes | Plural female animal name. | Dams |
| maleName | string | Yes | Singular male animal name. | Sire |
| maleNamePlural | string | Yes | Plural male animal name. | Sires |
| youngName | string | Yes | Singular young animal name. | Puppy |
| youngNamePlural | string | Yes | Plural young animal name. | Puppies |
| gestation | number | Yes | Average gestation length in days. | 63 |
CmsPage
38 propertiesPublic CMS page model with modular section layouts.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Unique page CUID. | cly_page_001 |
| organizationId | string | Yes | Organization ID. | cly_org_highland |
| title | string | Yes | Public page title. | About Our Kennel |
| slug | string | Yes | URL route path (e.g. 'home', 'about-us', 'contact'). | about-us |
| content | string | Yes | Base rich text or markdown content. | <p>Welcome to Highland Kennels...</p> |
| published | boolean | Yes | Visibility status on the public website. | |
| isHome | boolean | Yes | Whether this page serves as the root index page ('/'). | |
| excerpt | string| null | Optional | Page summary used for SEO meta description. | Learn about our 15 years of ethical breeding practices. |
| heroAlbumId | string| null | Optional | Optional photo album ID used as hero background banner. | null |
| heroTitle | string| null | Optional | Title displayed in the hero overlay banner. | Welcome to Highland Kennels |
| heroSubtitle | string| null | Optional | Subtitle displayed in the hero overlay banner. | Dedicated to raising healthy, well-socialized Golden Retrievers. |
| heroButtonPrimaryText | string| null | Optional | Call-to-action text for the primary hero button. | Explore Puppies |
| heroButtonPrimaryLinkType | string| null | Optional | Link resolution type for the primary hero button. Values: PAGECUSTOM | PAGE |
| heroButtonPrimaryUrl | string| null | Optional | Target custom URL for the primary hero button. | null |
| heroButtonPrimaryPageId | string| null | Optional | Target CMS page ID for the primary hero button. | cly_page_litters |
| heroButtonSecondaryText | string| null | Optional | Call-to-action text for the secondary hero button. | Contact Us |
| heroButtonSecondaryLinkType | string| null | Optional | Link resolution type for the secondary hero button. Values: PAGECUSTOM | CUSTOM |
| heroButtonSecondaryUrl | string| null | Optional | Target custom URL for the secondary hero button. | /contact |
| heroButtonSecondaryPageId | string| null | Optional | Target CMS page ID for the secondary hero button. | null |
| seoTitle | string| null | Optional | Custom SEO <title> tag override. | About Highland Kennels | Ethical Breeder |
| seoDescription | string| null | Optional | Custom SEO <meta name="description"> tag. | Learn about our 15 years of ethical pedigree Golden Retriever breeding practices. |
| seoKeywords | string| null | Optional | Comma-separated SEO keyword phrases. | golden retriever, breeder, scotland, pedigree |
| canonicalUrl | string| null | Optional | Custom canonical URL override. | https://highlandkennels.com/about-us |
| noIndex | boolean | Optional | Disallow search engines indexing this page. | |
| noFollow | boolean | Optional | Disallow search engines following links on this page. | |
| ogTitle | string| null | Optional | Open Graph social sharing card title. | About Highland Kennels |
| ogDescription | string| null | Optional | Open Graph social sharing card description. | Learn about our 15 years of ethical breeding practices. |
| ogImage | string| null | Optional | Open Graph 1200x630 social share image URL. | https://r2.breeder.cloud/facilities/yard.webp |
| ogType | string| null | Optional | Open Graph object type (e.g. 'website', 'article'). | website |
| twitterCard | string| null | Optional | Twitter / X card format. | summary_large_image |
| twitterTitle | string| null | Optional | Twitter card title. | About Highland Kennels |
| twitterDescription | string| null | Optional | Twitter card description. | Learn about our 15 years of ethical breeding practices. |
| twitterImage | string| null | Optional | Twitter card preview image URL. | https://r2.breeder.cloud/facilities/yard.webp |
| structuredDataType | string| null | Optional | Schema.org structured data type (e.g. 'WebPage', 'AboutPage', 'ContactPage'). | AboutPage |
| structuredDataCustom | object| null | Optional | Custom JSON-LD schema overrides. | null |
| translations | object| null | Optional | Localized translations map for non-default content languages (e.g. Dutch). | {"nl":{"title":"Over Ons","heroTitle":"Welkom bij Highland Kennels"}} |
| sections | CmsSection[] | Optional | Ordered list of modular sections. | [] |
| createdAt | string | Yes | Creation date. | 2024-01-15T10:00:00.000Z |
CmsDynamicPageSeo
17 propertiesSearch Engine Optimization (SEO) rules and template strings for dynamic CMS pages in breeder.cloud.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Optional | Dynamic SEO rule CUID. | cly_seo_001 |
| organizationId | string | Optional | Organization ID. | cly_org_highland |
| routeType | string | Yes | Dynamic route identifier. Values: ANIMALS_OVERVIEWALL_ACTIVE_FEMALESALL_ACTIVE_MALESANIMAL_PROFILE_DETAILLITTERS_OVERVIEWLITTER_DETAIL | ANIMALS_OVERVIEW |
| titleTemplate | string | Yes | SEO title template with dynamic token tags. | Our {breedPlural} | {orgName} |
| descriptionTemplate | string | Yes | SEO meta description template with dynamic token tags. | Meet all pedigree {breedPlural} raised at {orgName} in {orgCity}. |
| keywordsTemplate | string| null | Optional | SEO keyword tokens template. | {breed}, {breedPlural}, {orgCity} breeder, pedigree |
| ogImage | string| null | Optional | Fallback social share image URL. | https://r2.breeder.cloud/branding/og-default.jpg |
| ogType | string | Optional | Open Graph type. | website |
| twitterCard | string | Optional | Twitter card display type. | summary_large_image |
| noIndex | boolean | Optional | Whether to disallow search engine indexing. | |
| noFollow | boolean | Optional | Whether to disallow search engine crawling links. | |
| structuredDataType | string | Optional | Schema.org structured data type. | CollectionPage |
| isCustomized | boolean | Optional | Whether this route uses custom overrides rather than breed defaults. | |
| interpolatedPreviewTitle | string | Optional | Sample resolved title preview. | Our Golden Retrievers | Highland Kennels |
| interpolatedPreviewDescription | string | Optional | Sample resolved description preview. | Meet all pedigree Golden Retrievers raised at Highland Kennels in Edinburgh. |
| createdAt | string | Optional | Creation date. | 2024-01-15T10:00:00.000Z |
| updatedAt | string | Optional | Last update timestamp. | 2024-01-15T10:00:00.000Z |
CmsDynamicPageSeoInput
10 propertiesPayload for configuring dynamic page SEO rules.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| routeType | string | Yes | Dynamic route identifier. Values: ANIMALS_OVERVIEWALL_ACTIVE_FEMALESALL_ACTIVE_MALESANIMAL_PROFILE_DETAILLITTERS_OVERVIEWLITTER_DETAIL | ANIMALS_OVERVIEW |
| titleTemplate | string | Yes | SEO title template with dynamic token tags. | Our {breedPlural} | {orgName} |
| descriptionTemplate | string | Yes | SEO meta description template with dynamic token tags. | Meet all pedigree {breedPlural} raised at {orgName} in {orgCity}. |
| keywordsTemplate | string| null | Optional | SEO keyword tokens template. | {breed}, {breedPlural}, {orgCity} breeder, pedigree |
| ogImage | string| null | Optional | Fallback social share image URL. | https://r2.breeder.cloud/branding/og-default.jpg |
| ogType | string | Optional | Open Graph type. | website |
| twitterCard | string | Optional | Twitter card display type. | summary_large_image |
| noIndex | boolean | Optional | Whether to disallow search engine indexing. | |
| noFollow | boolean | Optional | Whether to disallow search engine crawling links. | |
| structuredDataType | string | Optional | Schema.org structured data type. | CollectionPage |
CmsSection
21 propertiesModular content block within a CMS page.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Section CUID. | cly_sec_001 |
| pageId | string | Yes | Parent page ID. | cly_page_001 |
| title | string| null | Optional | Section header title. | Our Facilities & Care |
| subtitle | string| null | Optional | Section subtitle or tagline. | Dedicated to excellence in ethical breeding. |
| description | string| null | Optional | Section description or introduction text. | Spacious grounds and dedicated puppy socialization nursery. |
| type | string | Yes | Section layout widget type. Values: DEFAULTANIMAL_SHOWCASECERTIFICATIONSCONTACT_FORM | DEFAULT |
| order | integer | Yes | Display sort order index. | 0 |
| columnsCount | integer | Yes | Number of grid columns (1 to 6). | 2 |
| animalShowcaseBreed | string| null | Optional | Filter showcased animals by breed/race name when type is ANIMAL_SHOWCASE. | Golden Retriever |
| animalShowcaseSex | string| null | Optional | Filter showcased animals by sex ('FEMALE' or 'MALE') when type is ANIMAL_SHOWCASE. | FEMALE |
| animalShowcaseStatus | string| null | Optional | Filter showcased animals by lifecycle status ('ACTIVE', 'INACTIVE', 'FUTURE', 'RETIRED') when type is ANIMAL_SHOWCASE. | ACTIVE |
| animalId | string| null | Optional | Linked animal ID for contextual contact form or showcase. | null |
| waitingListId | string| null | Optional | Linked waiting list ID for reservation form. | null |
| formButtonText | string| null | Optional | Custom submit button label on contact form. | Send Message |
| formSuccessMessage | string| null | Optional | Custom confirmation message shown upon form submission. | Thank you for reaching out! We will reply shortly. |
| formShowPhone | boolean| null | Optional | Whether to show the phone number input field in the contact form. | |
| formShowSubject | boolean| null | Optional | Whether to show the subject input field in the contact form. | |
| formLanguage | string| null | Optional | Language code for the form labels and validation. | en |
| translations | object| null | Optional | Localized translations map for section text fields (title, subtitle, description, form buttons). | {"nl":{"title":"Onze Faciliteiten","subtitle":"Toegewijd aan uitmuntendheid"}} |
| columns | CmsColumn[] | Optional | Columns inside this section. | [] |
| certifications | CmsCertification[] | Optional | Linked certifications if type is CERTIFICATIONS. | [] |
CmsColumn
17 propertiesIndividual column card or widget within a CMS section.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Column CUID. | cly_col_001 |
| sectionId | string | Yes | Parent section ID. | cly_sec_001 |
| title | string| null | Optional | Column card title. | Spacious Exercise Yard |
| content | string| null | Optional | Rich text content. | <p>Over 5 acres of fenced agility grass...</p> |
| imageUrl | string| null | Optional | Image media URL. | https://r2.breeder.cloud/facilities/yard.webp |
| imageAlt | string| null | Optional | Accessibility alt text. | Dogs running on grassy field |
| type | string | Yes | Column widget type. Values: RICH_TEXTIMAGECUSTOMCERTIFICATIONCONTACT_FORM | RICH_TEXT |
| order | integer | Yes | Column order within section. | 0 |
| animalId | string| null | Optional | Linked animal ID for column widget. | null |
| waitingListId | string| null | Optional | Linked waiting list ID for column widget. | null |
| certificationId | string| null | Optional | Linked certification ID if type is CERTIFICATION. | null |
| formButtonText | string| null | Optional | Custom submit button label on contact form column. | null |
| formSuccessMessage | string| null | Optional | Custom confirmation message shown upon form submission. | null |
| formShowPhone | boolean| null | Optional | Whether to show the phone number input field in the contact form column. | |
| formShowSubject | boolean| null | Optional | Whether to show the subject input field in the contact form column. | |
| formLanguage | string| null | Optional | Language code for the form labels and validation. | en |
| translations | object| null | Optional | Localized translations map for column content (title, rich text HTML, captions, alt text). | {"nl":{"title":"Ruime Speelweide","content":"<p>Meer dan 2 hectare...</p>"}} |
CmsPhotoAlbum
9 propertiesPublic photo gallery album.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Album CUID. | cly_album_01 |
| organizationId | string | Yes | Organization ID. | cly_org_highland |
| title | string | Yes | Album title. | Spring 2024 Litter Gallery |
| slug | string | Yes | URL slug. | spring-2024-litter |
| description | string| null | Optional | Album description. | Photos of our puppies from 2 to 8 weeks old. |
| coverUrl | string| null | Optional | Cover thumbnail URL. | https://r2.breeder.cloud/albums/cover-01.webp |
| order | integer | Yes | Sort order index. | 0 |
| isPublic | boolean | Yes | Public visibility flag. | |
| items | CmsPhotoAlbumItem[] | Optional | Photos in album. | [] |
CmsPhotoAlbumItem
6 propertiesIndividual photo within an album.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Photo item CUID. | cly_photo_01 |
| albumId | string | Yes | Album ID. | cly_album_01 |
| url | string | Yes | High resolution image URL. | https://r2.breeder.cloud/albums/photo-1.webp |
| title | string| null | Optional | Photo title. | Week 4 Garden Play |
| caption | string| null | Optional | Caption or description. | Puppies exploring outdoor agility grass for the first time. |
| order | integer | Yes | Display sort order. | 0 |
CmsCertification
13 propertiesOfficial breeder credentials, club memberships, and health certifications.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Certification CUID. | cly_cert_01 |
| organizationId | string | Yes | Organization ID. | cly_org_highland |
| type | string | Yes | Accreditation type. Values: CERTIFICATIONASSOCIATION | CERTIFICATION |
| title | string | Yes | Certificate or club title. | FCI Official Kennel Accreditation |
| description | string| null | Optional | Details and certificate ID. | Officially registered breeder with FCI and Dutch Kennel Club Raad van Beheer. |
| imageUrl | string| null | Optional | Badge or seal image URL. | https://r2.breeder.cloud/badges/fci.webp |
| url | string| null | Optional | Verification link URL. | https://www.fci.be/kennel-verify/8849 |
| expiresAt | string| null | Optional | Expiration date for the badge/media asset (ISO 8601). | 2028-12-31T23:59:59.000Z |
| memberSince | string| null | Optional | Date when membership in the association began (ISO 8601). | 2018-05-12T00:00:00.000Z |
| status | string | Yes | Calculated validity status. Values: ACTIVEEXPIREDNO_EXPIRY | ACTIVE |
| isExpired | boolean | Yes | Whether the certificate is expired. | |
| hasIdentificationSystem | boolean | Optional | Whether this certification/association tracks member or registration IDs for animals. | |
| order | integer | Yes | Display sort order. | 0 |
CmsContactSubmission
14 propertiesLead capture and inbound inquiry message received from the public website contact form.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Submission CUID. | cly_sub_01 |
| organizationId | string | Yes | Organization ID. | cly_org_highland |
| name | string | Yes | Sender's full name. | Jane Doe |
| string | Yes | Sender's email address. | jane.doe@example.com | |
| phone | string| null | Optional | Sender's telephone number. | +31 6 98765432 |
| subject | string| null | Optional | Inquiry topic or subject line. | Inquiry regarding Autumn 2024 Golden Retriever Litter |
| message | string | Yes | Full message content. | Hello, we are looking for a female puppy for our active family... |
| language | string | Yes | Locale used when submitting. | en |
| status | string | Yes | Processing status. Values: UNREADREADREPLIEDARCHIVED | UNREAD |
| animalId | string| null | Optional | Linked animal ID if submitted from animal profile page. | cly1abc1230001xyz |
| waitingListId | string| null | Optional | Linked waiting list ID if created/reserved. | null |
| pageId | string| null | Optional | Source page ID. | cly_page_001 |
| metadata | object| null | Optional | Custom key-value metadata. | {"source":"google_search"} |
| createdAt | string | Yes | Received timestamp. | 2024-05-01T14:22:00.000Z |
SubmitContactFormInput
12 propertiesPayload required to submit a public contact inquiry form.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| organizationId | string | Yes | Target organization ID (or provided via ?org= query parameter). | cly_org_highland |
| name | string | Yes | Sender's name (1 to 100 characters). | Jane Doe |
| string | Yes | Valid email address. | jane.doe@example.com | |
| message | string | Yes | Inquiry message body (1 to 5000 characters). | Hello, we are looking for an active family companion. |
| phone | string | Optional | Optional contact phone number. | +31 6 98765432 |
| subject | string | Optional | Optional subject line. | Puppy Reservation Question |
| pageId | string | Optional | ID of the source page. | cly_page_001 |
| pageSlug | string | Optional | Slug of the source page. | about-us |
| animalId | string | Optional | Target animal ID if inquiring about a specific sire/dam/puppy. | cly1abc1230001xyz |
| waitingListId | string | Optional | Target waiting list ID. | null |
| language | string | Optional | Form locale code (default: 'en'). | en |
| metadata | object | Optional | Arbitrary key-value metadata object. | {"referrer":"instagram"} |
AnimalWeightRecord
4 propertiesHistorical weigh-in record tracking animal growth and development over time.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | integer | Yes | Numeric weight record ID. | 104 |
| animalId | string | Yes | Animal CUID. | cly1abc1230001xyz |
| weight | integer | Yes | Recorded weight value in grams. | 28400 |
| timestamp | string | Yes | Measurement timestamp. | 2024-03-01T08:00:00.000Z |
AnimalMedicalRecord
9 propertiesVeterinary diagnostic test result or health certificate attached to an animal.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Medical record CUID. | cly_med_01 |
| animalId | string | Yes | Animal CUID. | cly1abc1230001xyz |
| testName | string | Yes | Recorded test name. | Hip Dysplasia (HD) Evaluation |
| result | string | Yes | Diagnostic score or result (e.g. HD-A, Clear, Negative). | HD-A / Excellent (Norberg 40) |
| timestamp | string | Yes | Examination date. | 2024-02-15T11:00:00.000Z |
| veterinarian | string| null | Optional | Examining veterinarian or clinic. | Dr. Van Dijk - Utrecht Animal Clinic |
| notes | string| null | Optional | Clinical notes. | No signs of arthrosis; bilateral symmetrical joints. |
| validUntil | string| null | Optional | Expiration date for annual certificates. | null |
| localizedTestName | string | Optional | Translated test name based on requested locale. | Heupdysplasie (HD) Beoordeling |
AnimalCertificationNumber
7 propertiesOfficial registration or studbook identification number issued by an association or kennel club.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Unique CUID identifier of the association number record. | cly_acn_001 |
| animalId | string | Yes | CUID of the animal. | cly1abc1230001xyz |
| certificationId | string | Yes | CUID of the organization association or certification. | cly_cert_alaeu |
| identificationNumber | string | Yes | Identification or studbook registration number with the association. | ALAEU-12345 |
| certification | object| null | Optional | Linked organization certification/association details including title, type, and badge. | {"id":"cly_cert_alaeu","title":"ALAEU (Australian Labradoodle Association Europe)","type":"ASSOCIATION","hasIdentificationSystem":true} |
| createdAt | string | Yes | Creation timestamp. | 2024-01-10T12:00:00.000Z |
| updatedAt | string | Yes | Last update timestamp. | 2024-04-15T09:30:00.000Z |
PaginationMetadata
4 propertiesStandard pagination envelope returned by list queries.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| total | integer | Yes | Total count of matching records across all pages. | 48 |
| page | integer | Yes | Current page number (1-based). | 1 |
| limit | integer | Yes | Maximum records returned per page. | 20 |
| totalPages | integer | Yes | Total number of available pages. | 3 |
WebhookConfig
4 propertiesReal-time cache invalidation webhook configuration for an organization.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| organizationId | string | Yes | Organization CUID. | cly_org_highland |
| webhookUrl | string| null | Optional | Destination URL receiving cache invalidation POST requests. | https://highlandkennels.com/api/revalidate |
| webhookSecret | string| null | Optional | Secret token used to verify HMAC-SHA256 signatures. | whsec_live_9a8b7c6d5e4f3a2b |
| webhookEnabled | boolean | Yes | Whether webhook dispatching is active. | |
SetWebhookUrlInput
7 propertiesRequest payload used to set or update the client cache invalidation webhook URL.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| url | string| null | Optional | Webhook endpoint URL (alias: webhookUrl). | https://highlandkennels.com/api/revalidate |
| webhookUrl | string| null | Optional | Webhook endpoint URL. | https://highlandkennels.com/api/revalidate |
| secret | string| null | Optional | Optional webhook secret for signature verification (alias: webhookSecret). | whsec_live_9a8b7c6d5e4f3a2b |
| webhookSecret | string| null | Optional | Optional webhook secret for signature verification. | whsec_live_9a8b7c6d5e4f3a2b |
| enabled | boolean | Optional | Whether to enable webhook calls. | |
| webhookEnabled | boolean | Optional | Whether to enable webhook calls. | |
| organizationId | string | Optional | Optional organization ID when calling root webhook endpoint. | cly_org_highland |
WebhookInvalidationPayload
8 propertiesPayload delivered via HTTP POST to the client's configured webhook URL upon database changes.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| event | string | Yes | Event identifier indicating cache invalidation. Values: cache:invalidateinvalidate | cache:invalidate |
| action | string | Yes | Database mutation operation that triggered invalidation. Values: createupdatedeleteupsertchange | update |
| model | string | Yes | Affected database model name. | Animal |
| organizationId | string | Yes | Organization CUID owning the changed entity. | cly_org_highland |
| timestamp | string | Yes | ISO 8601 UTC timestamp of the change event. | 2026-09-05T17:19:00.000Z |
| entityId | string| null | Optional | CUID or ID of the affected entity. | cly1abc1230001xyz |
| tags | string[] | Yes | Cache invalidation tags suitable for Next.js revalidateTag or CDN tag purging. | ["animals","animal:cly1abc1230001xyz","organization:cly_org_highland"] |
| metadata | object| null | Optional | Additional context about the mutation. | {"operation":"update","slug":"bella"} |
SalesContract
24 propertiesDigital sales contract and legally binding purchase agreement for litter offspring.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Unique contract CUID identifier. | cly_sc_001 |
| contractNumber | string | Yes | Official human-readable contract reference number. | BC-SC-2026-0001 |
| title | string | Yes | Contract title. | Puppy Sales Agreement - Bella Litter |
| status | string | Yes | Current lifecycle status of the contract. Values: DRAFTSENTVIEWEDSIGNEDVOIDEDEXPIRED | SIGNED |
| templateId | string| null | Optional | Source contract template CUID. | cly_tmpl_001 |
| matchId | string| null | Optional | Associated breeding match CUID. | cly_match_001 |
| animalId | string| null | Optional | Associated offspring animal CUID. | cly1abc1230001xyz |
| contactId | string | Yes | Buyer contact CUID. | cly_cnt_001 |
| waitingListId | string| null | Optional | Associated waiting list reservation CUID. | cly_wl_001 |
| purchasePrice | number| null | Optional | Agreed total purchase price. | 2500 |
| depositAmount | number| null | Optional | Reservation deposit amount. | 500 |
| depositPaid | boolean | Yes | Whether reservation deposit has been settled. | |
| fullyPaid | boolean | Yes | Whether the full purchase price has already been paid by the buyer (set at creation; forces the balance due to 0). | |
| paymentLinkUrl | string| null | Optional | Optional 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 |
| balanceDue | number| null | Optional | Remaining balance due upon animal handover. | 2000 |
| currency | string | Yes | Three-letter ISO currency code. | EUR |
| renderedContent | string | Yes | Full contract terms and conditions. | <h2>OFFICIAL PURCHASE AGREEMENT</h2>... |
| sections | array | Optional | Snapshot of template sections (title + rendered content) taken at creation; drives PDF section numbering. Empty for flat-content contracts. | [{ "title": "Health Guarantee", "content": "<p>...</p>" }] |
| customFields | object[] | Optional | Snapshot 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}] |
| identificationItems | string[] | Optional | Snapshot 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"] |
| signingToken | string | Yes | Secure URL token for buyer signing portal. | sc_tok_abc123 |
| pdfUrl | string| null | Optional | Public download URL for sealed PDF document. | https://r2.breeder.cloud/contracts/BC-SC-2026-0001.pdf |
| securityHash | string| null | Optional | SHA-256 cryptographic seal of signed terms and signatures. | e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 |
| createdAt | string | Yes | Contract creation timestamp. | 2026-09-08T10:00:00.000Z |
ContractTemplate
8 propertiesReusable contract template with dynamic buyer form field definitions.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Template CUID identifier. | cly_tmpl_001 |
| name | string | Yes | Template title. | Standard Puppy Purchase Agreement |
| description | string| null | Optional | Template description. | Standard agreement with health guarantee. |
| content | string | Yes | Contract text with placeholder tags. | <h2>PURCHASE AGREEMENT</h2>... |
| fields | object[] | Yes | Buyer 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"}}] |
| identificationItems | string[] | Optional | Optional 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"] |
| isDefault | boolean | Yes | Whether this is the default template for new contracts. | |
| createdAt | string | Yes | Creation timestamp. | 2026-09-08T10:00:00.000Z |
MatchAnimal
19 propertiesParent or offspring animal summary returned within a breeding match, including nest identification color and full weight record history.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Unique CUID identifier of the animal. | cly_offspring_001 |
| name | string| null | Optional | Call name of the animal, typically including the nest identification color for offspring. | Puppy Blue Collar |
| nameFull | string| null | Optional | Official pedigree or kennel club registered name. | null |
| sex | string| null | Optional | Biological sex of the animal. Values: femalemaleotherunknown | female |
| dateOfBirth | string| null | Optional | Date of birth (ISO 8601); derive age on the client side. | 2026-05-06T00:00:00.000Z |
| placeOfBirth | string| null | Optional | Two-letter ISO2 country code where the animal was born. | NL |
| dateOfDeath | string| null | Optional | Date of death if deceased (ISO 8601). | null |
| weightAtBirth | number| null | Optional | Birth weight in grams. | 350 |
| coat | string| null | Optional | Coat texture or length type (coat type). | Wavy |
| colorName | string| null | Optional | Coat color description. | Light Golden |
| raceName | string| null | Optional | Breed or race name (singular). | Golden Retriever |
| racePlural | string| null | Optional | Breed or race name (plural). | Golden Retrievers |
| size | string| null | Optional | Size category or measured height. | Medium |
| image | string| null | Optional | Primary profile image URL. | https://r2.breeder.cloud/animals/bella-profile.webp |
| excerpt | string| null | Optional | Short summary used in cards and public listings. | Top-ranked female with complete health test clearance. |
| description | string| null | Optional | Full bio, temperament description, and accolades. | Calm and friendly temperament, excellent retriever instincts. |
| nestColor | string| null | Optional | Nest (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 |
| nestColorHex | string| null | Optional | Resolved hexadecimal value of the nest identification color (e.g. '#3B82F6'), or null when no nest color is set. | #3B82F6 |
| weightRecords | AnimalWeightRecord[] | Yes | Full weigh-in history ordered by timestamp (descending). | [{"id":210,"animalId":"cly_offspring_001","weight":350,"timestamp":"2026-05-06T09:00:00.000Z"}] |
MatchExternalSire
6 propertiesReusable external sire (father from another breeder) linked to a match, including its registration ID and photo for client websites.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Unique CUID identifier of the external sire record. | cly_extsire_001 |
| name | string | Yes | Name of the external sire. | Champion Rocky of Highland |
| breed | string| null | Optional | Breed of the external sire. | Golden Retriever |
| registrationId | string| null | Optional | Registration 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 |
| photoUrl | string| null | Optional | Public URL of the photo uploaded specifically for this external sire. | https://r2.breeder.cloud/users/usr_123456/external-sires/cly_extsire_001/rocky.webp |
| registrationAssociation | object| null | Optional | Association 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 propertiesBreeding match (litter) pairing a mother (Dam) and father (Sire, internal or external) with their registered offspring.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| id | string | Yes | Unique CUID identifier of the match. | cly_match_001 |
| ownerId | string | Yes | User ID of the match owner/breeder. | usr_123456 |
| organizationId | string| null | Optional | Organization CUID owning the match. | cly_org_highland |
| motherId | string| null | Optional | CUID of the internal mother (Dam) animal, null when unknown. | cly1abc1230001xyz |
| fatherId | string| null | Optional | CUID of the internal father (Sire) animal, null for external or unknown sires. | cly_sire_001 |
| fatherName | string| null | Optional | Free-form name of an external father (Sire), used when no internal animal is linked. | Highland Duke Oliver |
| fatherBreed | string| null | Optional | Free-form breed of an external father (Sire). | Golden Retriever |
| externalSire | object| null | Yes | Reusable 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"}} |
| sireType | string | Yes | Whether the father is an internal animal or externally referenced free-form details. Values: INTERNALEXTERNAL | INTERNAL |
| isTbd | boolean | Yes | Whether the father (Sire) is still to be determined. | |
| notes | string| null | Optional | Free-form breeding notes. | Planned spring litter. |
| matingDate | string| null | Optional | Mating or covering date (ISO 8601). | 2026-03-02T00:00:00.000Z |
| estimatedDateOfBirth | string| null | Optional | Estimated date of birth derived from the mating date and species gestation (ISO 8601). | 2026-05-04T00:00:00.000Z |
| mother | object| null | Optional | Internal 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} |
| father | object| null | Optional | Internal 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} |
| animals | MatchAnimal[] | Yes | Registered 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"}]}] |
| createdAt | string | Yes | Match creation timestamp. | 2026-03-01T10:00:00.000Z |
| updatedAt | string | Yes | Last update timestamp. | 2026-05-20T09:00:00.000Z |
MatchListResponse
4 propertiesStandard response envelope returned by the list matches endpoint.
| Field Name | Type | Required | Description | Sample Value |
|---|---|---|---|---|
| success | boolean | Yes | Whether the request succeeded. | |
| organization | object| null | Optional | Organization the matches are scoped to (id, name, slug). | {"id":"cly_org_highland","name":"Highland Kennels","slug":"highland-kennels"} |
| data | Match[] | Yes | Paginated 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"}]}] |
| pagination | object | Yes | Pagination 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 valuesAnimal.statusGET /api/v1/animals?status={status}Represents the lifecycle and breeding availability status of an animal in breeder.cloud.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| ActiefActive | Animal is currently active and in the main breeding or companion program. | |
| InactiefInactive | Animal is currently not active in breeding or events, but remains in records. | |
| Toekomstige belofteFuture Prospect | Young animal or prospective candidate planned for future breeding or evaluation. | |
| GepensioneerdRetired | Animal has concluded its breeding or showing career and is retired. |
Sex
4 valuesAnimal.sexGET /api/v1/animals?sex={sex}WaitingList.preferenceSexBiological sex of the animal or preferred offspring sex filter.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| VrouwelijkFemale | Female animal (e.g. Dam, Queen, Mare, Doe, Hen). | |
| MannelijkMale | Male animal (e.g. Sire, Tom, Stallion, Buck, Cock). | |
| AndersOther | Non-binary, neutered, or specialized classification. | |
| Onbekend / Niet ingevuldUnknown / Unassigned | Sex not yet identified or pending DNA/pedigree verification. |
CmsDynamicPage
4 valuesCmsMenuItem.dynamicPageTarget identifier for dynamic automated pages rendered by client websites.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| Alle dieren (showcase)All Animals Showcase | Dynamic gallery showing all active animals and pedigree profiles. | |
| Actieve vrouwtjes (moederdieren)Active Dams / Females | Filtered dynamic view showcasing all active breeding females. | |
| Actieve mannetjes (vaderdieren)Active Sires / Males | Filtered dynamic view showcasing all active breeding males/studs. | |
| NestenoverzichtLitters Overview | Litter planning and announcements overview (/litters). |
CmsDynamicRouteType
6 valuesCmsDynamicPageSeo.routeTypeGET /api/v1/organizations/{id}/seo/dynamic-pagesSupported dynamic route types in the breeder.cloud REST API.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| DierenoverzichtAnimals Overview | All animals catalog page (/animals). | |
| Actieve vrouwtjesActive Females | Breeding females & dams showcase (/animals/females). | |
| Actieve mannetjesActive Males | Stud males & sires showcase (/animals/males). | |
| DierenprofielAnimal Profile | Individual animal profile page (/animals/[id]). | |
| NestenoverzichtLitters Overview | Litter planning and announcements (/litters). | |
| NestdetailsLitter Details | Individual litter page with parents (/litters/[id]). |
OrganizationCertificationType
2 valuesCmsCertification.typeGET /api/v1/organizations/{id}/certifications?type={type}Type of breeder badge, kennel club affiliation, or health accreditation.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| Certificering / OnderscheidingCertification / Award | Accredited health test certificate, breeder achievement, or official award. | |
| Vereniging / ClubAssociation / Club | Kennel club, breed association, registry, or syndicate membership. |
CertificationStatus
3 valuesCmsCertification.statusisCertificationExpired()Calculated expiration status of a certification or license.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| Actief / GeldigActive / Valid | Certification is currently active and before its expiration date. | |
| VerlopenExpired | Certification expiration date has passed and requires renewal. | |
| Geen vervaldatumNo Expiration | Permanent or lifetime certificate with no renewal requirement. |
CmsSectionType
4 valuesCmsSection.typeLayout structure and widget behavior of a CMS page section.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| Standaard rastersectieDefault Grid Section | Modular multi-column layout containing custom rich text, cards, or images. | |
| Dierenshowcase-rasterAnimal Showcase Grid | Dynamic showcase of organization animals filtered by breed, sex, or status with custom title, subtitle, and description. | |
| Certificeringencarrousel / rasterCertifications Carousel / Grid | Dedicated section showcasing kennel club badges and health testing credentials. | |
| Interactief contactformulierInteractive Contact Form | Context-aware inquiry form directly linked to an animal or waiting list. |
CmsColumnType
5 valuesCmsColumn.typeContent widget rendered inside a CMS section column.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| Rijke tekst / HTMLRich Text / HTML | Formatted WYSIWYG content, headings, paragraphs, and inline links. | |
| Enkele afbeelding / mediaSingle Image / Media | Banner image with alt text, captions, and responsive sizing. | |
| CertificeringsshowcaseCertification Showcase | Renders an embedded breeder certification badge with verify link. | |
| Aanvraagformulier-widgetInquiry Form Widget | Inbound message form with optional animal and waitlist context. | |
| Aangepaste HTML / embedCustom HTML / Embed | Raw embed code, custom script widget, or third-party iframe. |
CmsContactSubmissionStatus
4 valuesCmsContactSubmission.statusPATCH /api/v1/organizations/{id}/contact-submissions/{subId}Processing lifecycle status for inbound contact messages.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| OngelezenUnread | New incoming message awaiting breeder review. | |
| GelezenRead | Message has been viewed by the organization team. | |
| BeantwoordReplied | Response has been sent to the prospective customer or contact. | |
| GearchiveerdArchived | Message handled and stored in long-term archive. |
ContactType
3 valuesContact.typeGET /api/contactsClassification of external parties in the CRM contact directory.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| Klant / KoperCustomer / Buyer | Prospective or past puppy/kitten/offspring purchaser. | |
| Externe fokkerExternal Breeder | Partner breeder, stud owner, or external kennel. | |
| Algemene contactpersoonGeneral Contact | Veterinarian, trainer, supplier, co-owner, or business contact. |
WaitingListStatus
5 valuesWaitingList.statusReservation pipeline status for prospective puppy/kitten buyers.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| WachtendWaiting | Buyer is on the active waiting list awaiting an appropriate match. | |
| Toegewezen aan koppelingAssigned to Pairing | Buyer is allocated to a specific planned mating or pregnant dam. | |
| Toegewezen aan specifiek nageslachtAllocated Specific Offspring | A specific puppy/kitten in a born litter has been assigned to this buyer. | |
| VoltooidCompleted | Transfer of offspring completed successfully. | |
| Geannuleerd / TerugbetaaldCancelled / Refunded | Reservation withdrawn or deposit refunded. |
MedicalTestCategory
8 valuesMedicalTest.categoryAnimalMedicalRecord.categoryClinical health examination and diagnostic categorization.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| Algemene gezondheidGeneral Health | Routine checkups, vaccination records, and physical examinations. | |
| Genetica & DNA-panelenGenetic & DNA Panels | Inherited disease screenings, DNA test panels, and color genetics. | |
| Orthopedie & gewrichtenOrthopedics & Joints | Hip dysplasia (HD), Elbow dysplasia (ED), and Patella luxation scores. | |
| Oogheelkunde / ECVOOphthalmology / ECVO | Eye examinations, PRA screenings, and cataract evaluations. | |
| CardiologieCardiology | Heart auscultation, ECG, and echocardiography screenings. | |
| TandheelkundeDentistry | Bite evaluation, dentition counts, and oral health. | |
| ReproductieReproduction | Semen analysis, progesterone tests, ultrasound, and fertility reports. | |
| Overige gezondheidsonderzoekenOther Health Diagnostics | Specialized lab tests, allergy testing, and neurological screens. |
AnimalCategory
9 valuesAnimalPreset.animalCategoryBroad species classification for biological presets and templates.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| HondCanine / Dog | Dogs, puppies, stud dogs, and dams. | |
| KatFeline / Cat | Cats, kittens, studs, and queens. | |
| PaardEquine / Horse | Horses, foals, stallions, and mares. | |
| VogelAvian / Bird | Parrots, raptors, poultry, and waterfowl. | |
| KonijnRabbit | Rabbits, kits, bucks, and does. | |
| GeitCaprine / Goat | Goats, kids, bucks, and does. | |
| SchaapOvine / Sheep | Sheep, lambs, rams, and ewes. | |
| ReptielReptile | Snakes, lizards, geckos, and turtles. | |
| Andere diersoortOther Species | Other domesticated or exotic species. |
AnimalSortBy
7 valuesGET /api/v1/animals?sortBy={sortBy}Allowed sorting fields for animal list queries.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| AanmaakdatumCreated Date | Order by date added to breeder.cloud. | |
| RoepnaamCall Name | Order alphabetically by animal call name. | |
| GeboortedatumBirth Date | Order chronologically by birth date. | |
| Laatst bijgewerktLast Updated | Order by last modification timestamp. | |
| StatusStatus | Order by lifecycle status (ACTIVE, INACTIVE, etc.). | |
| RasBreed / Race | Order alphabetically by race or breed name. | |
| GeslachtSex | Order by sex classification. |
SortOrder
2 valuesGET /api/v1/animals?sortOrder={sortOrder}Direction for sorting query results.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| OplopendAscending | Lowest or earliest first (A-Z, 0-9, oldest to newest). | |
| AflopendDescending | Highest or newest first (Z-A, 9-0, newest to oldest). |
Role
2 valuesUser.roleSystem user access role in breeder.cloud.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| StandaardgebruikerStandard User | Standard breeder or kennel manager. | |
| BeheerderAdministrator | Platform administrator with system-wide permissions. |
Subscription
3 valuesUser.subscriptionPlatform tier subscription level.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| Gratis abonnementFree Tier | Basic kennel management with starter limits. | |
| Plus-abonnementPlus Tier | Advanced breeding management and automated matches. | |
| Premium-abonnementPremium Tier | Unlimited animals, AI presets, and full CMS website hosting. |
ContractStatus
6 valuesSalesContract.statusGET /api/v1/contracts?status={status}Lifecycle status of a sales contract or purchase agreement.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| ConceptDraft | Contract draft created and editable by breeder. | |
| Verzonden / in afwachting van handtekeningSent / Pending Signature | Contract sent to buyer awaiting review and signature. | |
| Bekeken door koperViewed by Buyer | Buyer has opened the signing link. | |
| OndertekendExecuted / Signed | Both parties have completed and signed the agreement. | |
| Ingetrokken / geannuleerdVoided / Cancelled | Contract has been voided by the breeder. | |
| VerlopenExpired | Signing token deadline has lapsed. |
ContractFieldType
6 valuesContractTemplate.fieldsSalesContract.customFieldsInput field type for dynamic buyer form fields in contract templates.
| Value (Literal) | Display Label | Meaning & Usage |
|---|---|---|
| Tekst (één regel)Single-line Text | Standard single line text input (address, phone, name). | |
| Tekst (meerdere regels)Multi-line Text | Multi-line text area for notes or extended descriptions. | |
| Selectievakje / bevestigingCheckbox / Acknowledgment | Boolean agreement or consent toggle. | |
| DatumkiezerDate Picker | Calendar date selection. | |
| VervolgkeuzelijstDropdown Select | Single selection from a list of predefined options. | |
| Digitale handtekeningDigital Signature | Electronic canvas signature pad. |
NestColor
25 valuesMatchAnimal.nestColorMatchAnimal.nestColorHexNest (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 Label | Meaning & Usage |
|---|---|---|
| RoodRed | Nest (collar) identification colour swatch: Red (#EF4444). Distinct from the coat colour. | |
| OranjeOrange | Nest (collar) identification colour swatch: Orange (#F97316). Distinct from the coat colour. | |
| AmberAmber | Nest (collar) identification colour swatch: Amber (#F59E0B). Distinct from the coat colour. | |
| GeelYellow | Nest (collar) identification colour swatch: Yellow (#EAB308). Distinct from the coat colour. | |
| LimoengroenLime | Nest (collar) identification colour swatch: Lime (#84CC16). Distinct from the coat colour. | |
| GroenGreen | Nest (collar) identification colour swatch: Green (#22C55E). Distinct from the coat colour. | |
| SmaragdgroenEmerald | Nest (collar) identification colour swatch: Emerald (#10B981). Distinct from the coat colour. | |
| OlijfgroenOlive | Nest (collar) identification colour swatch: Olive (#4D7C0F). Distinct from the coat colour. | |
| BruinBrown | Nest (collar) identification colour swatch: Brown (#78350F). Distinct from the coat colour. | |
| BronsBronze | Nest (collar) identification colour swatch: Bronze (#B45309). Distinct from the coat colour. | |
| MintMint | Nest (collar) identification colour swatch: Mint (#6EE7B7). Distinct from the coat colour. | |
| TurquoiseTurquoise | Nest (collar) identification colour swatch: Turquoise (#2DD4BF). Distinct from the coat colour. | |
| AppelblauwzeegroenTeal | Nest (collar) identification colour swatch: Teal (#14B8A6). Distinct from the coat colour. | |
| CyaanCyan | Nest (collar) identification colour swatch: Cyan (#06B6D4). Distinct from the coat colour. | |
| HemelsblauwSky | Nest (collar) identification colour swatch: Sky (#0EA5E9). Distinct from the coat colour. | |
| BlauwBlue | Nest (collar) identification colour swatch: Blue (#3B82F6). Distinct from the coat colour. | |
| IndigoIndigo | Nest (collar) identification colour swatch: Indigo (#6366F1). Distinct from the coat colour. | |
| VioletViolet | Nest (collar) identification colour swatch: Violet (#8B5CF6). Distinct from the coat colour. | |
| PaarsPurple | Nest (collar) identification colour swatch: Purple (#A855F7). Distinct from the coat colour. | |
| RozePink | Nest (collar) identification colour swatch: Pink (#EC4899). Distinct from the coat colour. | |
| BeigeBeige | Nest (collar) identification colour swatch: Beige (#D6D3D1). Distinct from the coat colour. | |
| GrijsGray | Nest (collar) identification colour swatch: Gray (#78716C). Distinct from the coat colour. | |
| WitWhite | Nest (collar) identification colour swatch: White (#FFFFFF). Distinct from the coat colour. | |
| ZwartBlack | Nest (collar) identification colour swatch: Black (#1E293B). Distinct from the coat colour. | |
| AangepastCustom | Custom 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.
GET /api/v1/openapi.json
Standard OpenAPI 3.1.0 JSON format. Compatible with Swagger Editor, Postman Collection Import, OpenAPI TypeScript Codegen, and Orval.
curl -X GET "https://breeder.cloud/api/v1/openapi.json"GET /api/v1/spec
Rich structured JSON specification including endpoints array, schemas dictionary, and full enums catalog with value descriptions.
curl -X GET "https://breeder.cloud/api/v1/spec"