organisations

Version 0.1.06 opérations

Organisations of the current user with role, permissions and scope

GET/organisationsSession du tableau de bord

Paramètres

Aucun paramètre.

Réponses

200
- idstring (uuid)obligatoire
- namestringobligatoire
- legalNamestringobligatoire
- roleIdstring (uuid)obligatoire
- rolestring | nullobligatoire
- roleNamestringobligatoire
- isOwnerbooleanobligatoire
- permissionsstring[]obligatoire
- scopestringobligatoire
  - enum: "all", "accounts"
- accountIdsstring[]obligatoire

Exemples de code

curl -X GET "$KONNECT_API_URL/organisations" \
  -H "Cookie: konnect_session=$KONNECT_SESSION"

Exemple : 200

[
  {
    "id": "id",
    "name": "name",
    "legalName": "legalName",
    "roleId": "roleId",
    "role": "role",
    "roleName": "roleName",
    "isOwner": true,
    "permissions": [
      "payments.view"
    ],
    "scope": "all",
    "accountIds": [
      "string"
    ]
  }
]

Identity, status facts and the computed canCollect with its reasons

GET/organisations/{id}Session du tableau de bord

Paramètres

idstringpathobligatoire

Réponses

200
- idstring (uuid)obligatoire
- namestringobligatoire
- legalNamestringobligatoire
- taxIdstringobligatoire
- countrystringobligatoire
- addressstring | nullobligatoire
- citystring | nullobligatoire
- postalCodestring | nullobligatoire
- phonestring | nullobligatoire
- emailstring | nullobligatoire
- websitestring | nullobligatoire
- kybStatusstringobligatoire
  - enum: "pending", "verified", "refused"
- contractSignedAtstring (date-time) | nullobligatoire
- activeAffiliationsnumberobligatoire
- canCollectbooleanobligatoire
  Computed: KYB verified, contract signed, one active affiliation
- reasonsstring[]obligatoire
- paymentAccountsPaymentAccountSummaryDto[]obligatoire
  Accounts within your scope
  - idstring (uuid)obligatoire
  - namestringobligatoire
  - slugstringobligatoire
  - isDefaultbooleanobligatoire
  - statusstringobligatoire
    - enum: "active", "paused", "archived"

Exemples de code

curl -X GET "$KONNECT_API_URL/organisations/id" \
  -H "Cookie: konnect_session=$KONNECT_SESSION"

Exemple : 200

{
  "id": "id",
  "name": "name",
  "legalName": "legalName",
  "taxId": "taxId",
  "country": "country",
  "address": "address",
  "city": "city",
  "postalCode": "postalCode",
  "phone": "phone",
  "email": "buyer@example.com",
  "website": "website",
  "kybStatus": "pending",
  "contractSignedAt": "2026-10-01T09:30:00.000Z",
  "activeAffiliations": 1,
  "canCollect": true,
  "reasons": [
    "kyb_pending"
  ],
  "paymentAccounts": [
    {
      "id": "id",
      "name": "name",
      "slug": "slug",
      "isDefault": true,
      "status": "active"
    }
  ]
}

Edit address, phone, email and website (legal identity is read-only)

PATCH/organisations/{id}Session du tableau de bord

Paramètres

idstringpathobligatoire

Corps de la requête application/json

addressstring | null
citystring | null
postalCodestring | null
phonestring | null
emailstring | null
websitestring | null

Réponses

200
- idstring (uuid)obligatoire
- namestringobligatoire
- legalNamestringobligatoire
- taxIdstringobligatoire
- countrystringobligatoire
- addressstring | nullobligatoire
- citystring | nullobligatoire
- postalCodestring | nullobligatoire
- phonestring | nullobligatoire
- emailstring | nullobligatoire
- websitestring | nullobligatoire
- kybStatusstringobligatoire
  - enum: "pending", "verified", "refused"
- contractSignedAtstring (date-time) | nullobligatoire
- activeAffiliationsnumberobligatoire
- canCollectbooleanobligatoire
  Computed: KYB verified, contract signed, one active affiliation
- reasonsstring[]obligatoire
- paymentAccountsPaymentAccountSummaryDto[]obligatoire
  Accounts within your scope
  - idstring (uuid)obligatoire
  - namestringobligatoire
  - slugstringobligatoire
  - isDefaultbooleanobligatoire
  - statusstringobligatoire
    - enum: "active", "paused", "archived"

Exemples de code

curl -X PATCH "$KONNECT_API_URL/organisations/id" \
  -H "Cookie: konnect_session=$KONNECT_SESSION" \
  -H "Content-Type: application/json" \
  -d '{
  "address": "address",
  "city": "city",
  "postalCode": "postalCode",
  "phone": "+216 70 000 000",
  "email": "buyer@example.com",
  "website": "website"
}'

Exemple : corps de la requête

{
  "address": "address",
  "city": "city",
  "postalCode": "postalCode",
  "phone": "+216 70 000 000",
  "email": "buyer@example.com",
  "website": "website"
}

Exemple : 200

{
  "id": "id",
  "name": "name",
  "legalName": "legalName",
  "taxId": "taxId",
  "country": "country",
  "address": "address",
  "city": "city",
  "postalCode": "postalCode",
  "phone": "phone",
  "email": "buyer@example.com",
  "website": "website",
  "kybStatus": "pending",
  "contractSignedAt": "2026-10-01T09:30:00.000Z",
  "activeAffiliations": 1,
  "canCollect": true,
  "reasons": [
    "kyb_pending"
  ],
  "paymentAccounts": [
    {
      "id": "id",
      "name": "name",
      "slug": "slug",
      "isDefault": true,
      "status": "active"
    }
  ]
}

Contract status (Documenso signing link: placeholder, always null)

GET/organisations/{id}/contractSession du tableau de bord

Paramètres

idstringpathobligatoire

Réponses

200
- statusstringobligatoire
  - enum: "signed", "unsigned"
- signedAtstring (date-time) | nullobligatoire
- signingUrlstring | nullobligatoire
  Documenso signing link when pending (not wired yet: always null)

Exemples de code

curl -X GET "$KONNECT_API_URL/organisations/id/contract" \
  -H "Cookie: konnect_session=$KONNECT_SESSION"

Exemple : 200

{
  "status": "signed",
  "signedAt": "2026-10-01T09:30:00.000Z",
  "signingUrl": "signingUrl"
}

Konnect compliance: mark the KYB verified (audited)

POST/organisations/{id}/kyb/verifySession du tableau de bord

Paramètres

idstringpathobligatoire

Corps de la requête application/json

reasonstringobligatoire

Réponses

Exemples de code

curl -X POST "$KONNECT_API_URL/organisations/id/kyb/verify" \
  -H "Cookie: konnect_session=$KONNECT_SESSION" \
  -H "Content-Type: application/json" \
  -d '{
  "reason": "Registry extract checked"
}'

Exemple : corps de la requête

{
  "reason": "Registry extract checked"
}

Konnect compliance: refuse the KYB with a reason (audited)

POST/organisations/{id}/kyb/refuseSession du tableau de bord

Paramètres

idstringpathobligatoire

Corps de la requête application/json

reasonstringobligatoire

Réponses

Exemples de code

curl -X POST "$KONNECT_API_URL/organisations/id/kyb/refuse" \
  -H "Cookie: konnect_session=$KONNECT_SESSION" \
  -H "Content-Type: application/json" \
  -d '{
  "reason": "Registry extract checked"
}'

Exemple : corps de la requête

{
  "reason": "Registry extract checked"
}