Skip to content
Book a demoStart your free trial

For clubs, associations and registries

Take your club's records with you, any time, in a documented format.

A club admin can ask for a copy of the club's own records in Breed Ledger from Settings. It arrives as bundle.zip, or as numbered parts when it is large, with JSON and CSV files, a manifest with a SHA-256 fingerprint for each data file and stored file so you can check the copy, and the format written out below.

What comes out

Your club's own records, as files you can open.

Members, animals of every species your club registers, pedigree links, registrations, events, pages and the history behind them come out as plain files. A dog club, a crested gecko club and a livestock association get the same layout.

In the export

Members, animals and files

  • Organization profile
  • Members
  • Animals with a registration or submission
  • Pedigree links
  • Ownership history
  • Litters
  • External identifiers
  • Genotype alleles
  • Phenotype records
  • Trait records
  • Health test results
  • Public notes on animals
  • Saved pairing results
  • Breeder credit requests
  • Litter application checks
  • Member contact details
  • Withdrawn membership applications
  • Registry parties
  • Membership tiers
  • Import file records: the name, size and confirmation of each import file, not the file itself
  • Shipping addresses and label orders
  • Files: photos, documents and certificates

Registrations and certificates

  • Registrations
  • Registration ledger
  • Registration history
  • Designation awards
  • Designation award history
  • Application reference numbers
  • Certificate settings
  • Certificate delivery history
  • Registration classification history
  • Registration classifications
  • Submissions, with their answers, history and settings

Events and entries

  • Events and entries
  • Event classes, results, image records, waitlists and sign-ups

Fees, services and payments

  • Payment records, without secrets
  • Litter application fees
  • Fees and fee policy
  • Services, their versions, fee rules and the species they apply to

Pages, rules, settings and history

  • Pages and posts
  • Member standing history
  • Audit history: the club's admin activity log and export events
  • Field policies and custom label names, with their history
  • Standing, litter and designation rules, with their history
  • Species, breeds, animal classes and standards
  • Import history: which file and row each imported record came from
  • Navigation menu
  • Unpublished page drafts
  • Rules sections
  • Sponsors
  • Contact form inquiries
  • Administrator notification preferences
  • Audit history: field edits, delegation, service and name changes

Not in the export

Some records are not the club's to take, or are not club records. These stay out, and the format section below lists what is left out, by reason.

  • Private member notes on animals and private health results kept in Breed Ledger.
  • A member's animal that was never registered with or submitted to the club, with its microchip number, photos and records.
  • Registrations an owner recorded with an outside registry.
  • Files of records that belong to a site rather than the club, and platform assets.
  • Copies of pedigree links that another organization keeps.
  • In the record files, passwords, sign-in tokens, API credentials, and payment account identifiers and keys are never exported.
  • Original import files. The export keeps a record of each confirmed file, and the club keeps its own originals.

How to ask for it

Request it in Settings, download it when it is ready.

  • Step 1

    A club admin asks

    In Settings, open Your data and choose Request export. If one is already being built, the request is not added a second time.

  • Step 2

    It is built and checked

    The export is built in the background and checked before it is marked ready. You can leave the page, and Breed Ledger emails the person who asked when it is ready.

  • Step 3

    Download it

    A ready download expires 7 days after it is prepared, so save it somewhere your club controls. A large export is split into parts of up to 100 MiB, named like bundle-part-2-of-3.zip.

On every plan

Export is not tied to a plan.

  • Any plan

    No plan gate

    The same request is open to a club on its trial, a club whose trial has ended and a club on a paid plan.

  • Always free

    Export costs nothing

    There is no charge to request or download an export.

Also free

Certificate checks stay free.

Anyone can check a certificate your club issued. The check needs no account and no paid plan.

The format

The format, written out.

The bundle is written in the format breedledger.organization-export, version 1. manifest.json records both. The tables below are the records the export describes, and every kind of record has one JSON file and one CSV file.

Format breedledger.organization-export, version 1

Layout of the bundle

Layout of the bundle
PathWhat it holds
README.mdA plain-text guide to the bundle: the format name and version, each JSON record file with its row count, the number of stored files, and what is not exported.
manifest.jsonThe format name and version, the organization, when the export was generated, and a SHA-256 fingerprint for each data file and stored file in the bundle, which you can use to check the copy; the manifest does not list itself. It also lists the files that could not be read and, for a large export, the part that holds each file.
data/<name>.jsonOne file per kind of record, with every row of that kind as JSON.
csv/<name>.csvThe same rows and columns as the JSON file, as CSV for a spreadsheet.
files/<bucket>/The stored files of the club, such as photos, documents and certificates, each listed in the manifest with the record that owns it.

Files, one per kind of record

Files, one per kind of record
RecordsJSON fileCSV file
Organization profiledata/organization.jsoncsv/organization.csv
Membersdata/members.jsoncsv/members.csv
Animalsdata/animals.jsoncsv/animals.csv
Pedigree linksdata/pedigree_links.jsoncsv/pedigree_links.csv
Registrationsdata/registrations.jsoncsv/registrations.csv
Ownership historydata/animal_transfers.jsoncsv/animal_transfers.csv
Littersdata/litter_applications.jsoncsv/litter_applications.csv
Eventsdata/org_events.jsoncsv/org_events.csv
Event entriesdata/org_event_entries.jsoncsv/org_event_entries.csv
Payment recordsdata/org_payments.jsoncsv/org_payments.csv
Pages and postsdata/org_pages.jsoncsv/org_pages.csv
External identifiersdata/animal_external_ids.jsoncsv/animal_external_ids.csv
Registration ledgerdata/animal_registrations.jsoncsv/animal_registrations.csv
Registration historydata/animal_registration_versions.jsoncsv/animal_registration_versions.csv
Genotype allelesdata/animal_alleles.jsoncsv/animal_alleles.csv
Phenotype recordsdata/animal_morphs.jsoncsv/animal_morphs.csv
Trait recordsdata/animal_traits.jsoncsv/animal_traits.csv
Health test resultsdata/animal_health_results.jsoncsv/animal_health_results.csv
Designation awardsdata/org_animal_designation_awards.jsoncsv/org_animal_designation_awards.csv
Designation award historydata/org_animal_designation_events.jsoncsv/org_animal_designation_events.csv
Public notes on animalsdata/org_animal_notes.jsoncsv/org_animal_notes.csv
Saved pairing resultsdata/pairing_results.jsoncsv/pairing_results.csv
Breeder credit requestsdata/animal_breeder_credit_requests.jsoncsv/animal_breeder_credit_requests.csv
Litter application feesdata/litter_application_payments.jsoncsv/litter_application_payments.csv
Litter application checksdata/litter_application_validations.jsoncsv/litter_application_validations.csv
Member contact detailsdata/member_org_contact_profiles.jsoncsv/member_org_contact_profiles.csv
Member standing historydata/membership_standing_periods.jsoncsv/membership_standing_periods.csv
Withdrawn membership applicationsdata/org_membership_withdrawals.jsoncsv/org_membership_withdrawals.csv
Application reference numbersdata/org_registration_application_references.jsoncsv/org_registration_application_references.csv
Certificate settingsdata/org_registration_certificate_configs.jsoncsv/org_registration_certificate_configs.csv
Certificate delivery historydata/org_registration_certificate_deliveries.jsoncsv/org_registration_certificate_deliveries.csv
Registration classification historydata/registration_classification_versions.jsoncsv/registration_classification_versions.csv
Registration classificationsdata/registration_classifications.jsoncsv/registration_classifications.csv
Registry partiesdata/registry_parties.jsoncsv/registry_parties.csv
Admin activity logdata/org_member_audit_log.jsoncsv/org_member_audit_log.csv
Export eventsdata/organization_export_request_events.jsoncsv/organization_export_request_events.csv
Fee scheduledata/org_fee_configs.jsoncsv/org_fee_configs.csv
Fee policydata/org_fee_policy.jsoncsv/org_fee_policy.csv
Registration fee windowsdata/org_animal_registration_fee_windows.jsoncsv/org_animal_registration_fee_windows.csv
Field policiesdata/organization_field_policies.jsoncsv/organization_field_policies.csv
Field policy historydata/organization_field_policy_versions.jsoncsv/organization_field_policy_versions.csv
Custom label namesdata/organization_party_label_policies.jsoncsv/organization_party_label_policies.csv
Custom label name historydata/organization_party_label_policy_versions.jsoncsv/organization_party_label_policy_versions.csv
Registration field policiesdata/organization_registration_field_policies.jsoncsv/organization_registration_field_policies.csv
Registration field policy historydata/organization_registration_field_policy_audit.jsoncsv/organization_registration_field_policy_audit.csv
Generation rulesdata/generation_standing_rule_sets.jsoncsv/generation_standing_rule_sets.csv
Standing rule historydata/organization_standing_policy_versions.jsoncsv/organization_standing_policy_versions.csv
Litter rule historydata/org_litter_policy_versions.jsoncsv/org_litter_policy_versions.csv
Designation list historydata/org_registry_designation_catalog_versions.jsoncsv/org_registry_designation_catalog_versions.csv
Species settingsdata/organization_species_configurations.jsoncsv/organization_species_configurations.csv
Accepted breedsdata/organization_species_breeds.jsoncsv/organization_species_breeds.csv
Species standardsdata/org_species_standards.jsoncsv/org_species_standards.csv
Animal classesdata/organization_animal_classes.jsoncsv/organization_animal_classes.csv
Species of the clubdata/org_species.jsoncsv/org_species.csv
Membership tiersdata/org_tiers.jsoncsv/org_tiers.csv
Event notification sign-upsdata/event_notification_subscriptions.jsoncsv/event_notification_subscriptions.csv
Event waitlistsdata/event_waitlist.jsoncsv/event_waitlist.csv
Event class templatesdata/org_event_class_templates.jsoncsv/org_event_class_templates.csv
Event class template itemsdata/org_event_class_template_items.jsoncsv/org_event_class_template_items.csv
Event classesdata/org_event_classes.jsoncsv/org_event_classes.csv
Event imagesdata/org_event_images.jsoncsv/org_event_images.csv
Event resultsdata/org_event_results.jsoncsv/org_event_results.csv
Submissionsdata/submissions.jsoncsv/submissions.csv
Submission answersdata/submission_field_values.jsoncsv/submission_field_values.csv
Approved submission recordsdata/submission_fact_versions.jsoncsv/submission_fact_versions.csv
Submission permissionsdata/submission_role_grants.jsoncsv/submission_role_grants.csv
Submission form versionsdata/submission_schema_versions.jsoncsv/submission_schema_versions.csv
Submission formsdata/submission_schemas.jsoncsv/submission_schemas.csv
Submission historydata/submission_state_transitions.jsoncsv/submission_state_transitions.csv
Submission rulesdata/submission_transitions.jsoncsv/submission_transitions.csv
Servicesdata/org_services.jsoncsv/org_services.csv
Service versionsdata/org_service_versions.jsoncsv/org_service_versions.csv
Service fee rulesdata/org_service_fee_rules.jsoncsv/org_service_fee_rules.csv
Service speciesdata/org_service_version_species.jsoncsv/org_service_version_species.csv
Import historydata/organization_import_row_provenance.jsoncsv/organization_import_row_provenance.csv
Import file recordsdata/organization_import_archives.jsoncsv/organization_import_archives.csv
Navigation menudata/org_nav_items.jsoncsv/org_nav_items.csv
Page draftsdata/org_page_drafts.jsoncsv/org_page_drafts.csv
Rules sectionsdata/org_rules_sections.jsoncsv/org_rules_sections.csv
Sponsorsdata/org_sponsors.jsoncsv/org_sponsors.csv
Contact form inquiriesdata/org_inquiries.jsoncsv/org_inquiries.csv
Administrator notification preferencesdata/org_admin_notification_prefs.jsoncsv/org_admin_notification_prefs.csv
Field edit historydata/field_edit_audit.jsoncsv/field_edit_audit.csv
Governance delegation historydata/governance_delegation_audit_log.jsoncsv/governance_delegation_audit_log.csv
Service change historydata/org_service_audit_events.jsoncsv/org_service_audit_events.csv
Name change historydata/organization_name_change_audit_log.jsoncsv/organization_name_change_audit_log.csv
Shipping addressesdata/shipping_addresses.jsoncsv/shipping_addresses.csv
Shipping label ordersdata/shipping_label_orders.jsoncsv/shipping_label_orders.csv
File names for whoever handles the files
  • organizations is written as data/organization.json and csv/organization.csv
  • org_memberships is written as data/members.json and csv/members.csv
  • animals is written as data/animals.json and csv/animals.csv
  • animals is written as data/pedigree_links.json and csv/pedigree_links.csv
  • org_registrations is written as data/registrations.json and csv/registrations.csv
  • animal_transfers is written as data/animal_transfers.json and csv/animal_transfers.csv
  • litter_applications is written as data/litter_applications.json and csv/litter_applications.csv
  • org_events is written as data/org_events.json and csv/org_events.csv
  • org_event_entries is written as data/org_event_entries.json and csv/org_event_entries.csv
  • org_payments is written as data/org_payments.json and csv/org_payments.csv
  • org_pages is written as data/org_pages.json and csv/org_pages.csv
  • animal_external_ids is written as data/animal_external_ids.json and csv/animal_external_ids.csv
  • animal_registrations is written as data/animal_registrations.json and csv/animal_registrations.csv
  • animal_registration_versions is written as data/animal_registration_versions.json and csv/animal_registration_versions.csv
  • animal_alleles is written as data/animal_alleles.json and csv/animal_alleles.csv
  • animal_morphs is written as data/animal_morphs.json and csv/animal_morphs.csv
  • animal_traits is written as data/animal_traits.json and csv/animal_traits.csv
  • animal_health_results is written as data/animal_health_results.json and csv/animal_health_results.csv
  • org_animal_designation_awards is written as data/org_animal_designation_awards.json and csv/org_animal_designation_awards.csv
  • org_animal_designation_events is written as data/org_animal_designation_events.json and csv/org_animal_designation_events.csv
  • org_animal_notes is written as data/org_animal_notes.json and csv/org_animal_notes.csv
  • pairing_results is written as data/pairing_results.json and csv/pairing_results.csv
  • animal_breeder_credit_requests is written as data/animal_breeder_credit_requests.json and csv/animal_breeder_credit_requests.csv
  • litter_application_payments is written as data/litter_application_payments.json and csv/litter_application_payments.csv
  • litter_application_validations is written as data/litter_application_validations.json and csv/litter_application_validations.csv
  • member_org_contact_profiles is written as data/member_org_contact_profiles.json and csv/member_org_contact_profiles.csv
  • membership_standing_periods is written as data/membership_standing_periods.json and csv/membership_standing_periods.csv
  • org_membership_withdrawals is written as data/org_membership_withdrawals.json and csv/org_membership_withdrawals.csv
  • org_registration_application_references is written as data/org_registration_application_references.json and csv/org_registration_application_references.csv
  • org_registration_certificate_configs is written as data/org_registration_certificate_configs.json and csv/org_registration_certificate_configs.csv
  • org_registration_certificate_deliveries is written as data/org_registration_certificate_deliveries.json and csv/org_registration_certificate_deliveries.csv
  • registration_classification_versions is written as data/registration_classification_versions.json and csv/registration_classification_versions.csv
  • registration_classifications is written as data/registration_classifications.json and csv/registration_classifications.csv
  • registry_parties is written as data/registry_parties.json and csv/registry_parties.csv
  • org_member_audit_log is written as data/org_member_audit_log.json and csv/org_member_audit_log.csv
  • organization_export_request_events is written as data/organization_export_request_events.json and csv/organization_export_request_events.csv
  • org_fee_configs is written as data/org_fee_configs.json and csv/org_fee_configs.csv
  • org_fee_policy is written as data/org_fee_policy.json and csv/org_fee_policy.csv
  • org_animal_registration_fee_windows is written as data/org_animal_registration_fee_windows.json and csv/org_animal_registration_fee_windows.csv
  • organization_field_policies is written as data/organization_field_policies.json and csv/organization_field_policies.csv
  • organization_field_policy_versions is written as data/organization_field_policy_versions.json and csv/organization_field_policy_versions.csv
  • organization_party_label_policies is written as data/organization_party_label_policies.json and csv/organization_party_label_policies.csv
  • organization_party_label_policy_versions is written as data/organization_party_label_policy_versions.json and csv/organization_party_label_policy_versions.csv
  • organization_registration_field_policies is written as data/organization_registration_field_policies.json and csv/organization_registration_field_policies.csv
  • organization_registration_field_policy_audit is written as data/organization_registration_field_policy_audit.json and csv/organization_registration_field_policy_audit.csv
  • generation_standing_rule_sets is written as data/generation_standing_rule_sets.json and csv/generation_standing_rule_sets.csv
  • organization_standing_policy_versions is written as data/organization_standing_policy_versions.json and csv/organization_standing_policy_versions.csv
  • org_litter_policy_versions is written as data/org_litter_policy_versions.json and csv/org_litter_policy_versions.csv
  • org_registry_designation_catalog_versions is written as data/org_registry_designation_catalog_versions.json and csv/org_registry_designation_catalog_versions.csv
  • organization_species_configurations is written as data/organization_species_configurations.json and csv/organization_species_configurations.csv
  • organization_species_breeds is written as data/organization_species_breeds.json and csv/organization_species_breeds.csv
  • org_species_standards is written as data/org_species_standards.json and csv/org_species_standards.csv
  • organization_animal_classes is written as data/organization_animal_classes.json and csv/organization_animal_classes.csv
  • org_species is written as data/org_species.json and csv/org_species.csv
  • org_tiers is written as data/org_tiers.json and csv/org_tiers.csv
  • event_notification_subscriptions is written as data/event_notification_subscriptions.json and csv/event_notification_subscriptions.csv
  • event_waitlist is written as data/event_waitlist.json and csv/event_waitlist.csv
  • org_event_class_templates is written as data/org_event_class_templates.json and csv/org_event_class_templates.csv
  • org_event_class_template_items is written as data/org_event_class_template_items.json and csv/org_event_class_template_items.csv
  • org_event_classes is written as data/org_event_classes.json and csv/org_event_classes.csv
  • org_event_images is written as data/org_event_images.json and csv/org_event_images.csv
  • org_event_results is written as data/org_event_results.json and csv/org_event_results.csv
  • submissions is written as data/submissions.json and csv/submissions.csv
  • submission_field_values is written as data/submission_field_values.json and csv/submission_field_values.csv
  • submission_fact_versions is written as data/submission_fact_versions.json and csv/submission_fact_versions.csv
  • submission_role_grants is written as data/submission_role_grants.json and csv/submission_role_grants.csv
  • submission_schema_versions is written as data/submission_schema_versions.json and csv/submission_schema_versions.csv
  • submission_schemas is written as data/submission_schemas.json and csv/submission_schemas.csv
  • submission_state_transitions is written as data/submission_state_transitions.json and csv/submission_state_transitions.csv
  • submission_transitions is written as data/submission_transitions.json and csv/submission_transitions.csv
  • org_services is written as data/org_services.json and csv/org_services.csv
  • org_service_versions is written as data/org_service_versions.json and csv/org_service_versions.csv
  • org_service_fee_rules is written as data/org_service_fee_rules.json and csv/org_service_fee_rules.csv
  • org_service_version_species is written as data/org_service_version_species.json and csv/org_service_version_species.csv
  • organization_import_row_provenance is written as data/organization_import_row_provenance.json and csv/organization_import_row_provenance.csv
  • organization_import_archives is written as data/organization_import_archives.json and csv/organization_import_archives.csv
  • org_nav_items is written as data/org_nav_items.json and csv/org_nav_items.csv
  • org_page_drafts is written as data/org_page_drafts.json and csv/org_page_drafts.csv
  • org_rules_sections is written as data/org_rules_sections.json and csv/org_rules_sections.csv
  • org_sponsors is written as data/org_sponsors.json and csv/org_sponsors.csv
  • org_inquiries is written as data/org_inquiries.json and csv/org_inquiries.csv
  • org_admin_notification_prefs is written as data/org_admin_notification_prefs.json and csv/org_admin_notification_prefs.csv
  • field_edit_audit is written as data/field_edit_audit.json and csv/field_edit_audit.csv
  • governance_delegation_audit_log is written as data/governance_delegation_audit_log.json and csv/governance_delegation_audit_log.csv
  • org_service_audit_events is written as data/org_service_audit_events.json and csv/org_service_audit_events.csv
  • organization_name_change_audit_log is written as data/organization_name_change_audit_log.json and csv/organization_name_change_audit_log.csv
  • shipping_addresses is written as data/shipping_addresses.json and csv/shipping_addresses.csv
  • shipping_label_orders is written as data/shipping_label_orders.json and csv/shipping_label_orders.csv
  • animal_media is stored with animals
  • lineage_links is stored with animals

Left out, by reason

Everything the export leaves out is grouped by reason below, with the number of kinds of record in each group.

Secrets and sign-in tokens (19 kinds of record)

Records that hold passwords, sign-in tokens, access keys and payment account identifiers. They are never exported.

Usage and abuse-control counters (18 kinds of record)

Counters the platform keeps to spot abuse and measure usage. They are not club records.

Platform operations (41 kinds of record)

Queues, counters, service state and notes kept by Breed Ledger staff. They are not club records.

Questions

Before you ask for it.

What is in the export?
The club's own records in Breed Ledger: members, animals, pedigree links, registrations, events, pages and the history behind them, plus the stored files such as photos and documents. Private member notes on animals, private health results and registrations an owner recorded with an outside registry are not included. The full list is on this page, grouped by kind of record.
Who can request it, and where?
A club admin can request it in Settings, under Your data. The person who asked is emailed when it is ready.
Is export free on every plan, including after a trial?
Yes. Export is not tied to a plan. A club on its trial, a club whose trial has ended and a club on a paid plan can each request one, and there is no charge.
What format is it in?
One bundle.zip for a small club, or several parts for a large one. Inside are JSON files, matching CSV files, a README.md and a manifest.json. The format is named breedledger.organization-export, version 1, and the manifest lists a SHA-256 fingerprint for each data file and stored file in the bundle, so you can check the copy.
How long does it take, and what if our registry is large?
It is built in the background and checked before it is marked ready, and you are emailed when it is. A large export is split into parts of up to 100 MiB, and the manifest names the part that holds each file.
What is left out?
In the record files, passwords, sign-in and handoff tokens, API credentials, and payment processor identifiers and keys are never exported. Original import files are not included; the export keeps a record of each confirmed file, and the club keeps its own originals. Usage counters and platform operations are not club records and are not exported either. This page groups what is left out by reason.
What if our club closes its account?
Ask for the export before your club's data is deleted. A ready download expires 7 days after it is prepared, or on the day the data is deleted if that comes first. Once the data is deleted there is nothing left to export and no export can be requested.

See it first

See where the export lives.

Book a demo and we will show your officers the Your data section in Settings and walk through what comes out.

Last updated