---
title: "Resolve the registered company context for payment evidence"
method: GET
path: "/v1/guard/payments/context/{connectionId}"
---

# Resolve the registered company context for payment evidence

`GET /v1/guard/payments/context/{connectionId}`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/guard/payments/context/{connectionId}`
- Auth: API key in header `X-Decionis-API-Key`

Uses the current ordinary workspace key to resolve Core's synchronized Accounts workspace, exact active verified Business Central company connection and current revision-bound native read grant. The key must have decision:read and decision:write; it is independent of Decionis-managed provider credentials. Returns non-secret registration metadata only: basis=persisted_connection_and_native_grant, provider_read_authority=not_checked, execution_available=false unless Decionis issues single-use permits for this connection, when it is true; a permit, never the flag, lets a payment post. The native shell must compare the returned tenant, environment and company with its actual session before saving this context. Payment and settlement calls compare every pinned assertion with fresh Core metadata again. No body or query parameters are accepted. This source candidate does not read Microsoft payment facts, refresh provider authority, or grant financial posting permission, and requires the matching Core and Commerce deployments.

## Path parameters

- `connectionId` string, uuid, required

## Headers

- `X-ERP-Region` string, required

## Response `200`

Current registered company metadata; no provider read or execution authority

- NativeConnectionContext: Current registered company metadata checked by Core. It does not verify payment facts through Microsoft, refresh provider authority, or grant posting permission.
  - `version` 'commerce-native-context-v1', required
  - `org_id` string, uuid, required
  - `workspace_environment` 'sandbox' | 'production', required
  - `connection_id` string, uuid, required
  - `expected_revision` integer, required
  - `environment_name` string, required
  - `company_id` string, uuid, required
  - `erp_type` 'D365_BC', required
  - `tenant_id` string, uuid, required
  - `basis` 'persisted_connection_and_native_grant', required
  - `provider_read_authority` 'not_checked', required
  - `execution_available` boolean, required

## Other responses

- `400`: Bounded error response
- `401`: Bounded error response
- `429`: Bounded error response
- `502`: Bounded error response
- `503`: Bounded error response

---

[API](https://skmtc.dev/decionis/apis/decionis-commerce-gate-api.md) · [All operations](https://skmtc.dev/decionis/apis/decionis-commerce-gate-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decionis/apis/decionis-commerce-gate-api/revisions/9fecb7109bf8?raw)