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.
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.
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.
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.
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.
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
| Path | What it holds |
|---|---|
| README.md | A 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.json | The 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>.json | One file per kind of record, with every row of that kind as JSON. |
| csv/<name>.csv | The 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
| Records | JSON file | CSV file |
|---|---|---|
| Organization profile | data/organization.json | csv/organization.csv |
| Members | data/members.json | csv/members.csv |
| Animals | data/animals.json | csv/animals.csv |
| Pedigree links | data/pedigree_links.json | csv/pedigree_links.csv |
| Registrations | data/registrations.json | csv/registrations.csv |
| Ownership history | data/animal_transfers.json | csv/animal_transfers.csv |
| Litters | data/litter_applications.json | csv/litter_applications.csv |
| Events | data/org_events.json | csv/org_events.csv |
| Event entries | data/org_event_entries.json | csv/org_event_entries.csv |
| Payment records | data/org_payments.json | csv/org_payments.csv |
| Pages and posts | data/org_pages.json | csv/org_pages.csv |
| External identifiers | data/animal_external_ids.json | csv/animal_external_ids.csv |
| Registration ledger | data/animal_registrations.json | csv/animal_registrations.csv |
| Registration history | data/animal_registration_versions.json | csv/animal_registration_versions.csv |
| Genotype alleles | data/animal_alleles.json | csv/animal_alleles.csv |
| Phenotype records | data/animal_morphs.json | csv/animal_morphs.csv |
| Trait records | data/animal_traits.json | csv/animal_traits.csv |
| Health test results | data/animal_health_results.json | csv/animal_health_results.csv |
| Designation awards | data/org_animal_designation_awards.json | csv/org_animal_designation_awards.csv |
| Designation award history | data/org_animal_designation_events.json | csv/org_animal_designation_events.csv |
| Public notes on animals | data/org_animal_notes.json | csv/org_animal_notes.csv |
| Saved pairing results | data/pairing_results.json | csv/pairing_results.csv |
| Breeder credit requests | data/animal_breeder_credit_requests.json | csv/animal_breeder_credit_requests.csv |
| Litter application fees | data/litter_application_payments.json | csv/litter_application_payments.csv |
| Litter application checks | data/litter_application_validations.json | csv/litter_application_validations.csv |
| Member contact details | data/member_org_contact_profiles.json | csv/member_org_contact_profiles.csv |
| Member standing history | data/membership_standing_periods.json | csv/membership_standing_periods.csv |
| Withdrawn membership applications | data/org_membership_withdrawals.json | csv/org_membership_withdrawals.csv |
| Application reference numbers | data/org_registration_application_references.json | csv/org_registration_application_references.csv |
| Certificate settings | data/org_registration_certificate_configs.json | csv/org_registration_certificate_configs.csv |
| Certificate delivery history | data/org_registration_certificate_deliveries.json | csv/org_registration_certificate_deliveries.csv |
| Registration classification history | data/registration_classification_versions.json | csv/registration_classification_versions.csv |
| Registration classifications | data/registration_classifications.json | csv/registration_classifications.csv |
| Registry parties | data/registry_parties.json | csv/registry_parties.csv |
| Admin activity log | data/org_member_audit_log.json | csv/org_member_audit_log.csv |
| Export events | data/organization_export_request_events.json | csv/organization_export_request_events.csv |
| Fee schedule | data/org_fee_configs.json | csv/org_fee_configs.csv |
| Fee policy | data/org_fee_policy.json | csv/org_fee_policy.csv |
| Registration fee windows | data/org_animal_registration_fee_windows.json | csv/org_animal_registration_fee_windows.csv |
| Field policies | data/organization_field_policies.json | csv/organization_field_policies.csv |
| Field policy history | data/organization_field_policy_versions.json | csv/organization_field_policy_versions.csv |
| Custom label names | data/organization_party_label_policies.json | csv/organization_party_label_policies.csv |
| Custom label name history | data/organization_party_label_policy_versions.json | csv/organization_party_label_policy_versions.csv |
| Registration field policies | data/organization_registration_field_policies.json | csv/organization_registration_field_policies.csv |
| Registration field policy history | data/organization_registration_field_policy_audit.json | csv/organization_registration_field_policy_audit.csv |
| Generation rules | data/generation_standing_rule_sets.json | csv/generation_standing_rule_sets.csv |
| Standing rule history | data/organization_standing_policy_versions.json | csv/organization_standing_policy_versions.csv |
| Litter rule history | data/org_litter_policy_versions.json | csv/org_litter_policy_versions.csv |
| Designation list history | data/org_registry_designation_catalog_versions.json | csv/org_registry_designation_catalog_versions.csv |
| Species settings | data/organization_species_configurations.json | csv/organization_species_configurations.csv |
| Accepted breeds | data/organization_species_breeds.json | csv/organization_species_breeds.csv |
| Species standards | data/org_species_standards.json | csv/org_species_standards.csv |
| Animal classes | data/organization_animal_classes.json | csv/organization_animal_classes.csv |
| Species of the club | data/org_species.json | csv/org_species.csv |
| Membership tiers | data/org_tiers.json | csv/org_tiers.csv |
| Event notification sign-ups | data/event_notification_subscriptions.json | csv/event_notification_subscriptions.csv |
| Event waitlists | data/event_waitlist.json | csv/event_waitlist.csv |
| Event class templates | data/org_event_class_templates.json | csv/org_event_class_templates.csv |
| Event class template items | data/org_event_class_template_items.json | csv/org_event_class_template_items.csv |
| Event classes | data/org_event_classes.json | csv/org_event_classes.csv |
| Event images | data/org_event_images.json | csv/org_event_images.csv |
| Event results | data/org_event_results.json | csv/org_event_results.csv |
| Submissions | data/submissions.json | csv/submissions.csv |
| Submission answers | data/submission_field_values.json | csv/submission_field_values.csv |
| Approved submission records | data/submission_fact_versions.json | csv/submission_fact_versions.csv |
| Submission permissions | data/submission_role_grants.json | csv/submission_role_grants.csv |
| Submission form versions | data/submission_schema_versions.json | csv/submission_schema_versions.csv |
| Submission forms | data/submission_schemas.json | csv/submission_schemas.csv |
| Submission history | data/submission_state_transitions.json | csv/submission_state_transitions.csv |
| Submission rules | data/submission_transitions.json | csv/submission_transitions.csv |
| Services | data/org_services.json | csv/org_services.csv |
| Service versions | data/org_service_versions.json | csv/org_service_versions.csv |
| Service fee rules | data/org_service_fee_rules.json | csv/org_service_fee_rules.csv |
| Service species | data/org_service_version_species.json | csv/org_service_version_species.csv |
| Import history | data/organization_import_row_provenance.json | csv/organization_import_row_provenance.csv |
| Import file records | data/organization_import_archives.json | csv/organization_import_archives.csv |
| Navigation menu | data/org_nav_items.json | csv/org_nav_items.csv |
| Page drafts | data/org_page_drafts.json | csv/org_page_drafts.csv |
| Rules sections | data/org_rules_sections.json | csv/org_rules_sections.csv |
| Sponsors | data/org_sponsors.json | csv/org_sponsors.csv |
| Contact form inquiries | data/org_inquiries.json | csv/org_inquiries.csv |
| Administrator notification preferences | data/org_admin_notification_prefs.json | csv/org_admin_notification_prefs.csv |
| Field edit history | data/field_edit_audit.json | csv/field_edit_audit.csv |
| Governance delegation history | data/governance_delegation_audit_log.json | csv/governance_delegation_audit_log.csv |
| Service change history | data/org_service_audit_events.json | csv/org_service_audit_events.csv |
| Name change history | data/organization_name_change_audit_log.json | csv/organization_name_change_audit_log.csv |
| Shipping addresses | data/shipping_addresses.json | csv/shipping_addresses.csv |
| Shipping label orders | data/shipping_label_orders.json | csv/shipping_label_orders.csv |
File names for whoever handles the files
organizationsis written asdata/organization.jsonandcsv/organization.csvorg_membershipsis written asdata/members.jsonandcsv/members.csvanimalsis written asdata/animals.jsonandcsv/animals.csvanimalsis written asdata/pedigree_links.jsonandcsv/pedigree_links.csvorg_registrationsis written asdata/registrations.jsonandcsv/registrations.csvanimal_transfersis written asdata/animal_transfers.jsonandcsv/animal_transfers.csvlitter_applicationsis written asdata/litter_applications.jsonandcsv/litter_applications.csvorg_eventsis written asdata/org_events.jsonandcsv/org_events.csvorg_event_entriesis written asdata/org_event_entries.jsonandcsv/org_event_entries.csvorg_paymentsis written asdata/org_payments.jsonandcsv/org_payments.csvorg_pagesis written asdata/org_pages.jsonandcsv/org_pages.csvanimal_external_idsis written asdata/animal_external_ids.jsonandcsv/animal_external_ids.csvanimal_registrationsis written asdata/animal_registrations.jsonandcsv/animal_registrations.csvanimal_registration_versionsis written asdata/animal_registration_versions.jsonandcsv/animal_registration_versions.csvanimal_allelesis written asdata/animal_alleles.jsonandcsv/animal_alleles.csvanimal_morphsis written asdata/animal_morphs.jsonandcsv/animal_morphs.csvanimal_traitsis written asdata/animal_traits.jsonandcsv/animal_traits.csvanimal_health_resultsis written asdata/animal_health_results.jsonandcsv/animal_health_results.csvorg_animal_designation_awardsis written asdata/org_animal_designation_awards.jsonandcsv/org_animal_designation_awards.csvorg_animal_designation_eventsis written asdata/org_animal_designation_events.jsonandcsv/org_animal_designation_events.csvorg_animal_notesis written asdata/org_animal_notes.jsonandcsv/org_animal_notes.csvpairing_resultsis written asdata/pairing_results.jsonandcsv/pairing_results.csvanimal_breeder_credit_requestsis written asdata/animal_breeder_credit_requests.jsonandcsv/animal_breeder_credit_requests.csvlitter_application_paymentsis written asdata/litter_application_payments.jsonandcsv/litter_application_payments.csvlitter_application_validationsis written asdata/litter_application_validations.jsonandcsv/litter_application_validations.csvmember_org_contact_profilesis written asdata/member_org_contact_profiles.jsonandcsv/member_org_contact_profiles.csvmembership_standing_periodsis written asdata/membership_standing_periods.jsonandcsv/membership_standing_periods.csvorg_membership_withdrawalsis written asdata/org_membership_withdrawals.jsonandcsv/org_membership_withdrawals.csvorg_registration_application_referencesis written asdata/org_registration_application_references.jsonandcsv/org_registration_application_references.csvorg_registration_certificate_configsis written asdata/org_registration_certificate_configs.jsonandcsv/org_registration_certificate_configs.csvorg_registration_certificate_deliveriesis written asdata/org_registration_certificate_deliveries.jsonandcsv/org_registration_certificate_deliveries.csvregistration_classification_versionsis written asdata/registration_classification_versions.jsonandcsv/registration_classification_versions.csvregistration_classificationsis written asdata/registration_classifications.jsonandcsv/registration_classifications.csvregistry_partiesis written asdata/registry_parties.jsonandcsv/registry_parties.csvorg_member_audit_logis written asdata/org_member_audit_log.jsonandcsv/org_member_audit_log.csvorganization_export_request_eventsis written asdata/organization_export_request_events.jsonandcsv/organization_export_request_events.csvorg_fee_configsis written asdata/org_fee_configs.jsonandcsv/org_fee_configs.csvorg_fee_policyis written asdata/org_fee_policy.jsonandcsv/org_fee_policy.csvorg_animal_registration_fee_windowsis written asdata/org_animal_registration_fee_windows.jsonandcsv/org_animal_registration_fee_windows.csvorganization_field_policiesis written asdata/organization_field_policies.jsonandcsv/organization_field_policies.csvorganization_field_policy_versionsis written asdata/organization_field_policy_versions.jsonandcsv/organization_field_policy_versions.csvorganization_party_label_policiesis written asdata/organization_party_label_policies.jsonandcsv/organization_party_label_policies.csvorganization_party_label_policy_versionsis written asdata/organization_party_label_policy_versions.jsonandcsv/organization_party_label_policy_versions.csvorganization_registration_field_policiesis written asdata/organization_registration_field_policies.jsonandcsv/organization_registration_field_policies.csvorganization_registration_field_policy_auditis written asdata/organization_registration_field_policy_audit.jsonandcsv/organization_registration_field_policy_audit.csvgeneration_standing_rule_setsis written asdata/generation_standing_rule_sets.jsonandcsv/generation_standing_rule_sets.csvorganization_standing_policy_versionsis written asdata/organization_standing_policy_versions.jsonandcsv/organization_standing_policy_versions.csvorg_litter_policy_versionsis written asdata/org_litter_policy_versions.jsonandcsv/org_litter_policy_versions.csvorg_registry_designation_catalog_versionsis written asdata/org_registry_designation_catalog_versions.jsonandcsv/org_registry_designation_catalog_versions.csvorganization_species_configurationsis written asdata/organization_species_configurations.jsonandcsv/organization_species_configurations.csvorganization_species_breedsis written asdata/organization_species_breeds.jsonandcsv/organization_species_breeds.csvorg_species_standardsis written asdata/org_species_standards.jsonandcsv/org_species_standards.csvorganization_animal_classesis written asdata/organization_animal_classes.jsonandcsv/organization_animal_classes.csvorg_speciesis written asdata/org_species.jsonandcsv/org_species.csvorg_tiersis written asdata/org_tiers.jsonandcsv/org_tiers.csvevent_notification_subscriptionsis written asdata/event_notification_subscriptions.jsonandcsv/event_notification_subscriptions.csvevent_waitlistis written asdata/event_waitlist.jsonandcsv/event_waitlist.csvorg_event_class_templatesis written asdata/org_event_class_templates.jsonandcsv/org_event_class_templates.csvorg_event_class_template_itemsis written asdata/org_event_class_template_items.jsonandcsv/org_event_class_template_items.csvorg_event_classesis written asdata/org_event_classes.jsonandcsv/org_event_classes.csvorg_event_imagesis written asdata/org_event_images.jsonandcsv/org_event_images.csvorg_event_resultsis written asdata/org_event_results.jsonandcsv/org_event_results.csvsubmissionsis written asdata/submissions.jsonandcsv/submissions.csvsubmission_field_valuesis written asdata/submission_field_values.jsonandcsv/submission_field_values.csvsubmission_fact_versionsis written asdata/submission_fact_versions.jsonandcsv/submission_fact_versions.csvsubmission_role_grantsis written asdata/submission_role_grants.jsonandcsv/submission_role_grants.csvsubmission_schema_versionsis written asdata/submission_schema_versions.jsonandcsv/submission_schema_versions.csvsubmission_schemasis written asdata/submission_schemas.jsonandcsv/submission_schemas.csvsubmission_state_transitionsis written asdata/submission_state_transitions.jsonandcsv/submission_state_transitions.csvsubmission_transitionsis written asdata/submission_transitions.jsonandcsv/submission_transitions.csvorg_servicesis written asdata/org_services.jsonandcsv/org_services.csvorg_service_versionsis written asdata/org_service_versions.jsonandcsv/org_service_versions.csvorg_service_fee_rulesis written asdata/org_service_fee_rules.jsonandcsv/org_service_fee_rules.csvorg_service_version_speciesis written asdata/org_service_version_species.jsonandcsv/org_service_version_species.csvorganization_import_row_provenanceis written asdata/organization_import_row_provenance.jsonandcsv/organization_import_row_provenance.csvorganization_import_archivesis written asdata/organization_import_archives.jsonandcsv/organization_import_archives.csvorg_nav_itemsis written asdata/org_nav_items.jsonandcsv/org_nav_items.csvorg_page_draftsis written asdata/org_page_drafts.jsonandcsv/org_page_drafts.csvorg_rules_sectionsis written asdata/org_rules_sections.jsonandcsv/org_rules_sections.csvorg_sponsorsis written asdata/org_sponsors.jsonandcsv/org_sponsors.csvorg_inquiriesis written asdata/org_inquiries.jsonandcsv/org_inquiries.csvorg_admin_notification_prefsis written asdata/org_admin_notification_prefs.jsonandcsv/org_admin_notification_prefs.csvfield_edit_auditis written asdata/field_edit_audit.jsonandcsv/field_edit_audit.csvgovernance_delegation_audit_logis written asdata/governance_delegation_audit_log.jsonandcsv/governance_delegation_audit_log.csvorg_service_audit_eventsis written asdata/org_service_audit_events.jsonandcsv/org_service_audit_events.csvorganization_name_change_audit_logis written asdata/organization_name_change_audit_log.jsonandcsv/organization_name_change_audit_log.csvshipping_addressesis written asdata/shipping_addresses.jsonandcsv/shipping_addresses.csvshipping_label_ordersis written asdata/shipping_label_orders.jsonandcsv/shipping_label_orders.csvanimal_mediais stored withanimalslineage_linksis stored withanimals
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?
Who can request it, and where?
Is export free on every plan, including after a trial?
What format is it in?
How long does it take, and what if our registry is large?
What is left out?
What if our club closes its account?
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