Connections

Get a connection

One connection with its status and passkey layer. Poll it after a disconnect to watch the passkey being removed.

GET/v1/connections/{id}

Authorization: Bearerid

Live API. A POST to /v1/cards issues a real card.

Authorizations

Authorizationstringrequired

Bearer token: Authorization: Bearer mk_live_.... Create a key in the AgentPay console under Developer, API keys.

Path parameters

idstringrequired

The connection id.

Response200application/json

connection_idstring

merchantstring

statusstring

Available options: pending, connected, removed

layerstring

Available options: session, passkey

passkey_statusstring

Available options: none, enrolling, awaiting_password, pending, connected, connected_unmanaged, failed, needs_person, login_failed, removing, removed, removed_locally

remote_removalstring

Available options: available, unavailable

passkey_connected_atstring

request_idstring

The request id, also in the X-Mooj-Request-Id header.

Errors

Status	Code	When
404	`connection_not_found`	No such connection on your account.

Get a connection

curl https://api.joomjoo.com/v1/connections/conn_5d2b... \
  -H "Authorization: Bearer $AGENTPAY_API_KEY"

import { AgentPay } from "@agentpay-global/sdk";

const agentpay = new AgentPay(process.env.AGENTPAY_API_KEY);
const conn = await agentpay.connections.get("conn_5d2b...");

import os
from agentpay import AgentPay

agentpay = AgentPay(api_key=os.environ["AGENTPAY_API_KEY"])
conn = agentpay.connections.get("conn_5d2b...")

200

{
  "connection_id": "conn_5d2b...",
  "merchant": "amazon",
  "status": "connected",
  "layer": "passkey",
  "passkey_status": "connected",
  "remote_removal": "available",
  "passkey_connected_at": "2026-10-24T22:10:00.000Z",
  "request_id": "req_a1b2c3"
}