Your organisation

GET/v1/organisationany credential

The organisation this credential acts for: its name, kinds, country, whether its profile is complete and whether certo approved it, and the effective scopes of this credential.

As an MCP tool: get_organisation

Response fields

id: uuid. The organisation's id.
name: string. Its name as the console shows it.
kinds: array of one of employer, university, provider. What it is on certo: an employer, a university, a learning provider.
country: string or null. Its country (ISO 3166-1 alpha-2).
website: string or null. Its website.
state: one of active, awaiting_certo. awaiting_certo: a university or a provider certo has not approved yet; it issues nothing until then.
profile_complete: boolean. Logo, name, country, website and description are in: needed before inviting, issuing or asking to read.
profile_missing: array of string. What the profile still needs.
credential: object. The credential that made this call.
credential.kind: one of api_key, oauth. An API key, or a person's connected assistant.
credential.name: string or null. The key's name; null for an assistant.
credential.scopes: array of string. What this credential may do today: its scopes within its maker's current role.

Errors

400 api.credential_in_url
401 api.key_invalid
401 api.key_expired
401 api.key_revoked
401 api.key_suspended
403 api.scope_missing
429 api.rate_limited