Retrieve an operator connection
GET
/v1/operator_connections/{id}Authorization
bearerAuth AuthorizationBearer <token>
Secret API key as a bearer token: Authorization: Bearer sk_live_….
Test keys (sk_test_…) are refused with 401 test_mode_unavailable.
Keys are issued per project in the dashboard. Never expose a secret
key in browser or mobile code.
In: header
Path Parameters
id*string
Operator connection id (opc_…).
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/operator_connections/opc_r3mq7z2kw5xt4nvb6cyj2ega2c"{
"id": "opc_r3mq7z2kw5xt4nvb6cyj2ega2c",
"object": "operator_connection",
"operator": "op_example",
"mode": "byo",
"status": "active",
"capabilities": [
"refund.full"
],
"created": 1791770000
}{
"error": {
"type": "api_error",
"code": "test_mode_unavailable",
"message": "test keys are not accepted by this API; use a live secret key",
"request_id": "req_8f3a1c9e5b7d2f4a6c0e9b1d"
}
}{
"error": {
"type": "invalid_request_error",
"code": "resource_missing",
"message": "no such payment_intent",
"request_id": "req_8f3a1c9e5b7d2f4a6c0e9b1d"
}
}