The account's connection to a supplier's API
/v1/account/suppliers/{supplier_id}/connectionStatus and hints only; credentials are never returned.
- Called by
- Account client
- Scope
- orders:read
Path parameters
- supplier_idstringrequired
Supplier ID or slug.
Responses
200The connection.Show
- created_atstring (date-time)required
- credentialsmap of stringrequired
Hints only: logins as entered, secrets as their last four characters.
- featuresarray of stringrequired
One of
place_orders,order_history,invoices,live_stock - last_checked_atstring (date-time) | nullrequired
- last_errorstring | nullrequired
- order_modestringrequired
test: orders are checked and recorded with the request that would be sent, and nothing is sent.live: orders are sent.off: refused.One of
off,test,live - statusstringrequired
verified: the supplier accepted the login at the last check or call.failed: it refused it.unverified: not checked yet, or the supplier was unreachable.One of
unverified,verified,failed - supplier_idstringrequired
- updated_atstring (date-time)required
- 401Missing, expired or revoked token (
invalid_token). - 403The token lacks a scope (
insufficient_scope), the account is suspended (account_suspended), or the client kind cannot call this. - 404Not found (
not_found). - 429Too many requests (
rate_limited); seeRetry-After.
curl -sS -X GET 'https://suppliers.presslane.ai/v1/account/suppliers/{supplier_id}/connection' \
-H "Authorization: Bearer $TOKEN"{
"created_at": "2026-11-09T08:00:00Z",
"credentials": {
"password": "…x9Qa",
"username": "buyer@example.com"
},
"features": [
"place_orders"
],
"last_checked_at": "2026-11-09T08:00:00Z",
"last_error": "string",
"order_mode": "off",
"status": "unverified",
"supplier_id": "string",
"updated_at": "2026-11-09T08:00:00Z"
}