GET/apps/accounting/v2/people/access-contract

getAccountingPeopleAccessContract

The approved contract does not provide a longer purpose statement for this operation.

App
Accounting
Contract
Accounting API 0.32.0
Lifecycle
preview
Runtime
not-public
Operation ID
getAccountingPeopleAccessContract
Canonical origin
https://accounting.runonvision.com

Purpose and use cases

GET /apps/accounting/v2/people/access-contract

The owning App is Vision Accounting. Accounting owns financial records, exact arithmetic, approvals, audit evidence, workspace grants, and ledger invariants.

Business use cases and out-of-scope behavior are not yet declared in the approved OpenAPI description.

Request

GET https://accounting.runonvision.com/apps/accounting/v2/people/access-contract

Authentication and authorization

No authentication requirement is declared for this operation.

Headers

  • Accept: application/json — recommended where a JSON response is declared.

Undeclared tracing, idempotency, conditional-request, and version headers are not assumed on this page.

Path and query parameters

This operation declares no path or query parameters.

Request body

This operation declares no request body.

Runnable examples

cURL
curl 'https://accounting.runonvision.com/apps/accounting/v2/people/access-contract' \
  --request GET \
  --header 'accept: application/json'
JavaScript (server-side)
const response = await fetch('https://accounting.runonvision.com/apps/accounting/v2/people/access-contract', {
  method: 'GET',
  headers: {
    accept: 'application/json',
  },
}

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()
Python 3 standard library
import json
import urllib.parse
import urllib.request

request = urllib.request.Request(
    'https://accounting.runonvision.com/apps/accounting/v2/people/access-contract',
    data=None,
    headers={
    "Accept": "application/json"
},
    method='GET',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

The current TypeScript reference client covers Platform token exchange and core reads. No native SDK helper is declared for this operation; use the HTTP contract directly and follow the SDK guidance.

Responses

StatusMeaningSchema
200Authoritative Accounting People access contractobject

Success response schema

FieldTypeRulesDescription
schemaVersion"vision-app-access.v2"requiredNot described in the contract.
appId"accounting"requiredNot described in the contract.
contractVersion"accounting-people.v1.0.0"requiredNot described in the contract.
capabilitiesarrayrequired; minimum items 2; maximum items 2Not described in the contract.
scopeKindsarrayrequiredNot described in the contract.
degradedBehavior"block_destructive_lifecycle"requiredNot described in the contract.
ownershipCheckobjectrequiredNot described in the contract.
ownershipCheck.protocol"prepared-decision.v1"requiredNot described in the contract.
ownershipCheck.preparePath"/apps/accounting/v1/people/offboarding/prepare"requiredNot described in the contract.
ownershipCheck.commitPath"/apps/accounting/v1/people/offboarding/commit"requiredNot described in the contract.
ownershipCheck.abortPath"/apps/accounting/v1/people/offboarding/abort"requiredNot described in the contract.
ownershipCheck.requiredScope"accounting.people:offboarding"requiredNot described in the contract.
ownershipCheck.blockerTypesarrayrequiredNot described in the contract.
ownershipCheck.maximumDecisionLifetimeSeconds300requiredNot described in the contract.
200 illustrative response
{
  "schemaVersion": "vision-app-access.v2",
  "appId": "accounting",
  "contractVersion": "accounting-people.v1.0.0",
  "capabilities": [
    {
      "id": "accounting.people:access",
      "businessDescription": "<businessDescription>",
      "scopeKinds": [
        "<not specified>"
      ],
      "sensitivity": "restricted",
      "approval": "owner",
      "lifecycleEffects": [
        "financial_responsibility"
      ]
    }
  ],
  "scopeKinds": [
    "<not specified>"
  ],
  "degradedBehavior": "block_destructive_lifecycle",
  "ownershipCheck": {
    "protocol": "prepared-decision.v1",
    "preparePath": "/apps/accounting/v1/people/offboarding/prepare",
    "commitPath": "/apps/accounting/v1/people/offboarding/commit",
    "abortPath": "/apps/accounting/v1/people/offboarding/abort",
    "requiredScope": "accounting.people:offboarding",
    "blockerTypes": [
      "<not specified>"
    ],
    "maximumDecisionLifetimeSeconds": 300
  }
}

Errors and troubleshooting

Error bodies and codes are shown only where the approved contract declares them. Use status, the declared error schema, and any correlation identifier returned by the App; do not infer that two Apps share one envelope.

    Collection behavior

    Pagination: not declared. Filtering/search: not declared. Sorting: not declared.

    Cursor lifetime, cursor binding, stable ordering, maximum traversal, and unknown-filter behavior are not assumed unless stated by a parameter description or schema constraint above.

    Operational behavior

    • Rate limit: No operation-specific limit or 429 response is declared.
    • Retry: Retry only when the documented error model or response headers authorize it. Timeout and backoff values are not declared by this operation.
    • Idempotency: No idempotency header or replay window is declared.
    • Concurrency: No ETag, If-Match, or optimistic-version header is declared.

    Security and privacy

    • Keep client credentials and bearer tokens on trusted servers.
    • Send only to the exact approved HTTPS origin and audience.
    • Treat response data according to the owning App's classification and retention policy; the OpenAPI contract does not itself grant data access.
    • Do not log credentials, tokens, complete private payloads, or secrets.

    Edge cases and known documentation gaps

    • No detailed operation description.
    • Business roles, timeout, retry budget, rate value, idempotency window, and concurrency behavior are absent unless explicitly stated above.

    No related operation is identified by the contract tags.

    Contract history and evidence