Skip to main content
GET
Retrieve a partner

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

id
string<uuid>
requerido

Identifier of the partner, as returned by the create call.

Ejemplo:

"00000000-0000-0000-0000-000000000000"

Respuesta

OK

applicationsCount
integer<int64>
requerido

How many M2M applications are currently attached to this partner. A non-zero value is what makes DELETE answer 409 (IDE-1049).

Ejemplo:

2

createdAt
string
requerido

When the partner was created (RFC 3339).

Ejemplo:

"2026-01-15T09:30:00Z"

displayName
string
requerido

Human-readable name, unique within the organization.

Ejemplo:

"Loja do Zé"

id
string
requerido

Server-generated identifier of the partner (UUID). This is the value to pass as partnerId when creating an application, and the value that travels in the credential's partner claim.

Ejemplo:

"00000000-0000-0000-0000-000000000000"

ipAllowlist
object[] | null
requerido

The partner's own IP allowlist, or null when it inherits the organization's list. Null and an empty list are NOT the same thing here: null is inheritance, and an empty own list cannot be stored.

permissions
object[] | null
requerido

What the partner may do, per product.

scope
object[] | null
requerido

Where the partner may do it, per product and dimension. An empty list means the partner is not restricted by instance in any product.

state
enum<string>
requerido

Whether the partner's credentials are honoured. Note this never reads "expired": expiry is derived from validUntil at decision time, so a closed window shows here as "active" with a past validUntil.

Opciones disponibles:
active,
suspended
Ejemplo:

"active"

updatedAt
string
requerido

When it was last modified (RFC 3339).

Ejemplo:

"2026-01-15T09:30:00Z"

validFrom
string<date-time> | null
requerido

Start of the validity window (RFC 3339), or null when it is open-ended.

Ejemplo:

"2026-01-01T00:00:00Z"

validUntil
string<date-time> | null
requerido

End of the validity window (RFC 3339), or null when it is open-ended. A past value means every credential of this partner is already refused.

Ejemplo:

"2027-01-01T00:00:00Z"