Get a processor connection · Ownrecord docs

Returns one processor connection (pcon_…) of the entity: status, key hint, publishable key, account, webhook endpoint and last event, and the last connection test. Keys and secrets are never returned. Connections of another entity or mode are resource_not_found.

At a glance

REST: GET /api/v1/processor_connections/{id}
MCP tool: processor_connections_get
Operation ID: processor_connections.get
Scope: Legal entity
Permission: processors:read
Risk tier: read
Dry run: Not supported
Idempotency: Not needed (read only)
Modes: Test and live
Authentication: API key with the processors:read scope
Since: M4

Request

Path parameters

Field	Type	Description
`id`	`pcon_…` ID

Query parameters

This operation takes no query parameters.

Response

200 OK with a JSON object:

Field	Type	Description
`id`	`pcon_…` ID
`object`	`"processor_connection"`
`entityId`	`ent_…` ID
`livemode`	boolean
`processor`	one of `stripe`, `mollie`, `fake`
`label`	string
`status`	one of `active`, `degraded`, `disconnected`
`statusReason`	string or null
`accountId`	string or null
`keyHint`	string
`publishableKey`	string or null
`checkoutComponent`	one of `stripe_payment_element`, `redirect`, `fake`
`webhook`	object
`webhook.mode`	one of `managed`, `manual`
`webhook.url`	string
`webhook.endpointId`	string or null
`webhook.lastEventAt`	date-time or null
`lastTest`	object
`lastTest.ok`	boolean
`lastTest.missingPermissions`	array of string
`lastTest.message`	string or null
`lastTest.checkedAt`	date-time
`failures`	object or null
`disconnectedAt`	date-time or null
`createdAt`	date-time
`updatedAt`	date-time
`version`	integer (at least 1)

Examples

A Stripe connection

HTTP

GET /api/v1/processor_connections/pcon_01m4vyt4mxe0s9zzk90373z6p6
Authorization: Bearer or_test_…

Response (200):

JSON

{
  "id": "pcon_01m4vyt4mxe0s9zzk90373z6p6",
  "object": "processor_connection",
  "entityId": "ent_01m4ttwd3veh9apbewxheq5xh4",
  "livemode": false,
  "processor": "stripe",
  "label": "Stripe",
  "status": "active",
  "statusReason": null,
  "accountId": "acct_1ExampleAccount01",
  "keyHint": "rk_test_…AbCd",
  "publishableKey": "pk_test_ExampleOnlyNotARealKey000000000AbCd",
  "checkoutComponent": "stripe_payment_element",
  "webhook": {
    "mode": "managed",
    "url": "https://ownrecord.io/api/webhooks/stripe/pcon_01m4vyt4mxe0s9zzk90373z6p6",
    "endpointId": "we_1ExampleEndpoint01",
    "lastEventAt": null
  },
  "lastTest": {
    "ok": true,
    "missingPermissions": [],
    "message": null,
    "checkedAt": "2026-10-14T12:00:00.000Z"
  },
  "failures": null,
  "disconnectedAt": null,
  "createdAt": "2026-10-14T12:00:00.000Z",
  "updatedAt": "2026-10-14T12:00:00.000Z",
  "version": 1
}

Errors

Code	HTTP status	When	What to do
`resource_not_found`	404	No such connection for this entity in this mode.	Check the ID and that your credentials are scoped to the right organization, entity, brand and mode.
`scope_required`	400	The request names no legal entity.	Call the operation with credentials or a target at its level: an organization, a legal entity, a brand or the platform (`details.required_scope`).
`permission_denied`	403	You can't see processor connections here.	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, dry_run_not_supported, rate_limited, internal_error.

At a glance#

Request#

Path parameters#

Query parameters#

Response#

Examples#

A Stripe connection#

Errors#