---
title: "Export an organization's settings and transcription terms"
method: GET
path: "/organizations/{organizationId}/data-export/content"
tags: ["data-export", "customer-content"]
---

# Export an organization's settings and transcription terms

`GET /organizations/{organizationId}/data-export/content`

## Request

- Base URL: `https://vetnio.com/api/v2`
- URL: `https://vetnio.com/api/v2/organizations/{organizationId}/data-export/content`
- Auth: HTTP bearer

Exports the current stored settings and the current transcription term list of exactly this scope as versioned JSON (`schemaVersion` 1), with an `inventory` that lists what is included, what is excluded and how to interpret it. Credentials, billing identifiers and other scopes' private settings are never included. Values are read at request time, so this is neither a change history nor an atomic snapshot. Read-only. Covers the organization's identity, address, custom domains, billing presentation preferences, audio-retention policy and organization term list. Requires admin rights in the organization. Accepts a browser session or a personal API key; organization and workspace API keys (`sk_org_…`, `sk_ws_…`) get 403.

## Path parameters

- `organizationId` string, required: Identifier of the organization to export (a UUID). The caller must be an admin of it.

## Response `200`

Successful response

- OrganizationContentExport: The organization's current stored settings and organization transcription term list, with an inventory of what is included and excluded.
  - `schemaVersion` 1, required: Version of the export format. Currently always `1`.
  - `exportedAt` string, date-time, required: When this export was produced (ISO 8601, UTC). Values are read separately, so this is not the time of an atomic snapshot.
  - `scopeId` string, required: ID of the exported user, workspace or organization. Equal to `configuration.id`.
  - `termList` TranscriptionTermListOutput, required: The scope's current custom transcription vocabulary: names, abbreviations and specialist terms used as spelling and recognition hints. When no list has been saved, `terms` is empty, `version` is 0 and `updatedAt` and `updatedBy` are `null`.
    - `terms` string[], required: Terms in their stored spelling and order. Up to 200 terms, each at most 50 characters and four words. Empty when no list is saved.
    - `version` integer, required: Edit-concurrency revision of the list: 1 or higher for a saved list, 0 when none is saved. It increases with each save; earlier contents are not retained.
    - `updatedAt` string, date-time, nullable, required: When the list was last saved (ISO 8601, UTC). `null` when no list is saved.
    - `updatedBy` string, nullable, required: ID of the user who last saved the list (a UUID). `null` when no list is saved or that user's account has been deleted.
  - `inventory` object, required: Plain-English statements of what this export covers and how to read it, intended for audit records. The wording can change between releases, so do not parse it.
    - `included` string[], required: Categories of content included in this response.
    - `excluded` string[], required: Categories deliberately left out of this response, such as credentials, billing identifiers and other owners' settings.
    - `limitations` string[], required: How to interpret this export, for example that it contains current values only and is not an atomic snapshot.
  - `scope` 'organization', required: Exported scope. Always `organization` for this endpoint.
  - `configuration` object, required: Identity, address, email domains, audio retention policy and allowlisted preferences of the organization.
    - `id` string, required: ID of the organization (a UUID).
    - `name` string, required: Organization name.
    - `address` object, nullable, required: Postal address stored for the organization. Every part is optional and omitted when not set. When the organization is billed as one legal entity (`preferences.billingLegalName` is set), invoices are addressed here.
      - `street` string: Street address line. Absent when not set.
      - `attention` string: Attention line of the address, for example a department or contact person. Absent when not set.
      - `city` string: City. Absent when not set.
      - `stateProvince` string: State, province or county. Absent when not set.
      - `zipCode` string: Postal or ZIP code, as entered. Absent when not set.
      - `countryCode` string: Two-letter ISO 3166-1 alpha-2 country code. Absent when not set.
    - `customDomains` string[], required: Email domains that belong to the organization. When a user with an address at one of these domains creates a workspace, or joins one through domain matching, that workspace is linked to the organization. Empty when there are none.
    - `audioFileRetentionPeriodInDays` integer, nullable, required: Audio retention period in days set by the organization (1 to 3650). Consultation and meeting recordings in its clinics older than this are deleted automatically; a clinic's own shorter period still applies. `null` when not set. Pending change requests are not included.
    - `createdAt` string, date-time, required: When the organization was created (ISO 8601, UTC).
    - `updatedAt` string, date-time, required: When the organization's stored details were last changed (ISO 8601, UTC).
    - `preferences` object, required: The organization's stored preferences. Only allowlisted keys are exported; billing-provider identifiers and integration credentials are left out. A key is absent when never set, and an organization with no stored preferences exports `{}`.
      - `billingLegalName` string: Legal entity name that invoices for the organization's clinics are addressed to, at the organization `address`. Absent when each clinic is billed under its own details.
      - `billingTaxExempt` string: VAT treatment of the billing entity, overriding the treatment derived from its country: - `none` — VAT is charged - `reverse` — reverse charge - `exempt` — VAT-exempt Absent when the country-based treatment applies.
      - `billingTaxId` string: VAT number of the billing entity. It replaces each clinic's own VAT number on invoices. Absent when not set.
      - `billingClinicAttentionLine` boolean: When `true`, each clinic's name is put on the invoice's attention line so a central accounts-payable team can route the cost. Absent means `false`.
      - `deepResearchUpgradeRequestsEnabled` boolean: Whether users in the organization's clinics can request the paid Deep Research add-on when their monthly Deep Research quota runs out. A clinic linked to several organizations allows requests if any of them enables this. Absent means `false`.
      - `aiTitlesEnabled` boolean: Default for AI-generated consultation titles in the organization's clinics. A clinic's own `aiTitlesEnabled` setting takes precedence; a clinic without one gets titles if any linked organization has `true`. Absent means not enabled by this organization.
      - `recordingView` 'waveform' | 'briefing': Default recording display for the organization's clinics. Each clinic can override it. If several linked organizations specify different defaults, briefing takes precedence. Absent means waveform unless another linked organization selects briefing.
      - `liveTranscriptionEnabled` boolean: Default for starting live transcription with consultation recording. Each clinic can override it. If several linked organizations specify different defaults, false takes precedence. Absent means enabled unless another linked organization disables it. Audio recording and transcription after recording are unaffected.

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/vetnio/apis/vetnio-api.md) - [All operations](https://skmtc.dev/vetnio/apis/vetnio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vetnio/apis/vetnio-api/revisions/d004afd5617d?raw)