Lister les domaines d'organisation

GET /v1/organization-domains · autorisation organization-domains:read

Liste les domaines d'organisation de l'environnement, du plus ancien au plus récent (ordre des identifiants), avec une pagination par curseur. Seule la pagination vers l'avant (after) est prise en charge. Une page contient de 1 à 100 éléments, 20 par défaut.

Requête

Champ Type Obligatoire Description
limit query non Taille de la page, de 1 à 100 (par défaut 20).
after query non Curseur provenant de list_metadata.after de la page précédente.
organization_id query non Uniquement les domaines de cette organisation (org_…).
domain query non Uniquement ce domaine (Unicode ou A-label, correspondance exacte).
status query non Uniquement les domaines dans ce statut : pending, verified, unverified, expired ou revoked.

Aucun corps de requête.

Réponse

200 OK avec une page de domaines.

{
  "data": [
    {
      "id": "odm_01j9xk3m7q8r2s4t6v8w0y2z4c",
      "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "domain": "acme.com",
      "status": "verified",
      "verification_method": "dns_txt",
      "txt_record_name": "_akp-verify.acme.com",
      "txt_record_value": "idp-verify=EXAMPLEtokenEXAMPLEtokenEXAMPLEtokenEXAMPLEtok",
      "verification_started_at": "2026-10-12T09:30:00.123456Z",
      "verified_at": "2026-10-12T09:35:00.654321Z",
      "last_checked_at": "2026-10-12T09:35:00.654321Z",
      "unverified_at": null,
      "next_check_at": "2026-10-13T09:35:00.654321Z",
      "last_failure_code": null,
      "capture_mode": "off",
      "sso_routing_enabled": false,
      "created_at": "2026-10-12T09:30:00.123456Z",
      "updated_at": "2026-10-12T09:35:00.654321Z",
      "version": 2
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Erreurs

HTTP code Quand
422 validation_failed Un filtre, limit ou le curseur est invalide (before et un order autre que asc ne sont pas pris en charge).
401 unauthenticated L'identifiant est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant ne dispose pas de l'autorisation requise.
429 rate_limited La limite de débit a été dépassée ; réessayez après la période Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez après la période Retry-After.

Exemple

curl "https://api.eu.keenauth.com/v1/organization-domains?organization_id=org_01j9xk3m7q8r2s4t6v8w0y2z4a&status=verified" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"