Querying organizations

organizations returns onboarded customers of your bank. Soft-deleted and surrendered organizations are excluded by default unless you explicitly filter for them.

All examples require a JWT — get one from the homepage first.

List organizations

query listOrganizations($first: Int) {
organizations(first: $first) {
  totalCount
  nodes {
    id
    name
    vatNumber
  }
  pageInfo {
    hasNextPage
    endCursor
  }
}
}

Sortable fields: name, vatNumber, surrenderedTime. Filterable fields: id, name, vatNumber, branchIdentifier, creationDate, isSurrendered, surrenderedTime.

Get one organization by ID

There's no top-level organizationById query. To fetch a single organization, filter organizations by id.

query getOrganizationById($id: UUID!) {
organizations(where: { id: { eq: $id } }, first: 1) {
  nodes {
    id
    name
    vatNumber
    branchIdentifier
    creationDate
  }
}
}

Expand related fields

Because every connection has projection enabled, you can pull related entities in the same round-trip. The fields you ask for determine which Includes the server emits — keep selections tight.

Note that extendedInformation is exposed as a list on Organization (it can have more than one entry per organization), and riskGroup lives on bankRelation, not on extendedInformation.

query expandedOrganizations {
organizations(first: 5) {
  nodes {
    id
    name
    bankRelation {
      isAjour
      ajourDate
      externalId
      riskGroup {
        id
        name
      }
    }
    extendedInformation {
      branchOffice {
        id
        name
      }
    }
    bankAccounts {
      id
      accountName
      registrationNumber
      accountNumber
    }
  }
}
}

Fetch the organization's statutes

statutes is a list of the organization's articles of association on file. Each entry carries isCurrent — true for the version in force — plus the unsigned file and (once signed) signedFile blobs. This is the organization-level record; for the statutes as submitted in a specific bank report, use the statute node on a bank report instead.

The list accepts where and order arguments — filter to the version in force with isCurrent, and sort by createdDate to get the newest first.

query organizationStatutes($id: UUID!) {
organizations(where: { id: { eq: $id } }, first: 1) {
  nodes {
    id
    name
    statutes(where: { isCurrent: { eq: true } }, order: { createdDate: DESC }) {
      isCurrent
      file { fileName fileExtension base64 }
      signedFile { fileName fileExtension base64 }
    }
  }
}
}

Sortable fields: createdDate. Filterable fields: isCurrent.

Dynamic attorneys

Banks with the dynamic-attorneys module grant attorneys from their own configurable card and procura settings. The granted attorneys hang off two parents: each Administrator carries everything your bank granted to that person (dynamicAttorneyCards, dynamicAttorneyProcuras), and each BankAccount carries the attorneys bound to that specific account. A procura whose bankAccount is null covers every account and appears only on the administrator. Grants issued by other banks the organization relates to are never visible. All of these fields are gated by hasDynamicAttorneysModule; without the module, projecting them returns an authorization error.

query organizationDynamicAttorneys($id: UUID!) {
organizations(where: { id: { eq: $id } }, first: 1) {
  nodes {
    id
    name
    administrators {
      id
      user { firstname lastname }
      dynamicAttorneyCards {
        id
        bankAttorneySettingsCard { id title }
        bankAccount { accountName registrationNumber accountNumber }
        signedFile { fileName fileExtension }
      }
      dynamicAttorneyProcuras {
        id
        bankAttorneySettingsProcura { id title }
        bankAccount { accountName registrationNumber accountNumber }
      }
    }
    bankAccounts {
      id
      accountName
      dynamicAttorneyCards { id }
      dynamicAttorneyProcuras { id }
    }
  }
}
}

bankAttorneySettingsCard / bankAttorneySettingsProcura resolve the card or procura setting in your bank's dynamic attorney configuration that the grant was made from — including its title, organizationFriendlyDescription, and legalDescription. A setting that has since been deactivated or archived still resolves, so historical grants keep their context. Add base64 on the file / signedFile blobs when you actually need the document bytes — these can be large.

Bank requests for an organization

Bank requests are forms (questionnaires) submitted by organizations as part of onboarding or ajour flows. They're scoped to the authenticated bank; filter by id if you have one.

query listBankRequests($first: Int) {
bankRequests(first: $first) {
  totalCount
  nodes {
    id
    name
    status
    createdDate
  }
}
}

Sortable fields: name. Filterable fields: id.