List operator connections
Returns the business's operator connections (shared by all its projects), newest first.
GET
/v1/operator_connectionsAuthorization
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
Query Parameters
limit?integer
Page size, 1–100. Default 10. Anything else returns 400 parameter_invalid.
starting_after?string
Cursor — the id of the last object on the previous page; returns the objects after it.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/operator_connections"{
"object": "list",
"url": "/v1/operator_connections",
"has_more": false,
"data": [
{
"id": "opc_r3mq7z2kw5xt4nvb6cyj2ega2c",
"object": "operator_connection",
"operator": "op_example",
"mode": "byo",
"status": "active",
"capabilities": [
"refund.full"
],
"created": 1791770000
}
]
}{
"error": {
"type": "invalid_request_error",
"code": "parameter_missing",
"message": "amount is required",
"param": "amount",
"request_id": "req_8f3a1c9e5b7d2f4a6c0e9b1d"
}
}{
"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"
}
}