Skip to main content

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
  }
}
}

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
    }
  }
}
}

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.