Skip to main content
Read one owner, or its tombstone
Preview. This operation is not served yet: it is part of the released contract (version 1.0.0). Build against a mock of the contract until the sandbox serves it; see Testing: mock and sandbox.

Autorizări

Authorization
string
header
obligatoriu

A key starts with gbd_live_ (production) or gbd_test_ (sandbox) and ends in a CRC32 checksum of its secret part, so a mistyped or truncated key is refused before any lookup, as is a key of the other environment. The prefix is registered with public secret scanners (GitHub secret scanning, TruffleHog, GitGuardian): a key found in a public repository is revoked at once and your technical contact is told. Gridbeds stores only a hash of each key. One partner may hold two keys per environment during a rotation. Operations list the scopes they need; the scopes are OAuth 2.0 scope tokens, so short-lived access tokens from a client-credentials grant can be offered later beside keys, with the same scopes and no change to any operation.

Parametri cale

owner_id
string
obligatoriu
Pattern: ^own_[0-7][0-9a-hjkmnp-tv-z]{25}$
Exemplu:

"own_63g5d4zsqj809bf5rwekga54a5"

Răspuns

The owner or its tombstone.

id
string
obligatoriu
Pattern: ^own_[0-7][0-9a-hjkmnp-tv-z]{25}$
Exemplu:

"own_63g5d4zsqj809bf5rwekga54a5"

status
enum<string>
obligatoriu

inactive when every published property of this owner is inactive.

Opțiuni disponibile:
active,
inactive
type
enum<string>
obligatoriu
Opțiuni disponibile:
company,
individual
display_name
string
obligatoriu
version
integer<int64>
obligatoriu

Grows on every change visible to this channel; ignore a lower one. Not a counter — do not expect consecutive values.

Interval necesar: x >= 1
updated_at
string<date-time>
obligatoriu
Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$
Exemplu:

"2026-10-16T09:30:00Z"

Additive. A sole trader is type individual.

Opțiuni disponibile:
company,
sole_trader,
individual
company
object | null

Only for type company.

languages
string[]

BCP 47.

Pattern: ^[a-z]{2,3}(-[A-Z]{2})?$
logo
object | null
connected_at
string<date-time> | null

Additive. When the host behind this owner connected an account of yours through owner connect; null when not connected, including after the host disconnects in Gridbeds (owner.updated).

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$
Exemplu:

"2026-10-16T09:30:00Z"