Get the legal acceptance · Ownrecord docs

Returns which versions of Ownrecord's Terms of Service and Data Processing Agreement the organization accepted, the versions in effect now, and any announced change.

Each document's status is accepted; update_announced when a material change is announced and not accepted yet (it takes effect on upcoming.effectiveDate, at least 30 days after the announcement); acceptance_required when a material change is in effect and an owner or admin must accept it; or, for the DPA, not_accepted until it is accepted, which the go-live checklist requires. actionRequired is true when any document needs acceptance now.

Readable by every member of the organization.

At a glance

REST: GET /api/v1/legal_acceptance
MCP tool: legal_acceptance_get
Operation ID: legal.acceptance_get
Scope: Organization
Permission: org:read
Risk tier: read
Dry run: Not supported
Idempotency: Not needed (read only)
Modes: Test and live
Authentication: API key with the org:read scope
Since: M12

Request

Query parameters

This operation takes no query parameters.

Response

200 OK with a JSON object:

Field	Type	Description
`object`	`"legal_acceptance"`
`organizationId`	`org_…` ID
`actionRequired`	boolean
`updateAnnounced`	boolean
`documents`	array of object
`documents[].document`	one of `terms`, `dpa`
`documents[].title`	string
`documents[].status`	one of `accepted`, `update_announced`, `acceptance_required`, `not_accepted`, `not_applicable`
`documents[].acceptedVersion`	string or null
`documents[].acceptedAt`	date-time or null
`documents[].current`	object
`documents[].current.version`	string
`documents[].current.effectiveDate`	string
`documents[].current.status`	one of `draft`, `approved`
`documents[].current.url`	string
`documents[].current.versionUrl`	string
`documents[].upcoming`	object or null
`documents[].acceptableVersions`	array of string

Examples

Terms accepted, DPA not yet

HTTP

GET /api/v1/legal_acceptance
Authorization: Bearer or_test_…

Response (200):

JSON

{
  "object": "legal_acceptance",
  "organizationId": "org_01m4tx5nj7ekd958x53w4bntcg",
  "actionRequired": false,
  "updateAnnounced": false,
  "documents": [
    {
      "document": "terms",
      "title": "Terms of Service",
      "status": "accepted",
      "acceptedVersion": "1.0",
      "acceptedAt": "2026-10-26T09:30:00.000Z",
      "current": {
        "version": "1.0",
        "effectiveDate": "2026-10-26",
        "status": "draft",
        "url": "/legal/terms",
        "versionUrl": "/legal/terms/1.0"
      },
      "upcoming": null,
      "acceptableVersions": ["1.0"]
    },
    {
      "document": "dpa",
      "title": "Data Processing Agreement",
      "status": "not_accepted",
      "acceptedVersion": null,
      "acceptedAt": null,
      "current": {
        "version": "1.0",
        "effectiveDate": "2026-10-26",
        "status": "draft",
        "url": "/legal/dpa",
        "versionUrl": "/legal/dpa/1.0"
      },
      "upcoming": null,
      "acceptableVersions": ["1.0"]
    }
  ]
}

Errors

Code	HTTP status	When	What to do
`permission_denied`	403	You can't read this organization.	Ask an organization owner or admin for a role or scope that allows this action.

It can also return these common errors: validation_failed, api_version_unsupported, authentication_required, api_key_invalid, resource_not_found, dry_run_not_supported, rate_limited, internal_error.

At a glance#

Request#

Query parameters#

Response#

Examples#

Terms accepted, DPA not yet#

Errors#