Skip to main content

Querying bank packages

A bank package (bankReport in the schema) is the bundle of documents an organization submits to satisfy ajour requirements. Use the queries below to list packages submitted to your bank, fetch a specific one, or combine package reads with other top‑level entities. For per‑component reads — constitution, administrator changes, statute, summary, accounting, business volume, tax residency, approvers, self‑declaration, legal documents, screening — see the dedicated sub‑pages.

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

List bank reports​

query listBankReports($first: Int) {
bankReports(first: $first) {
  totalCount
  nodes {
    id
    publishedTime
    finishedDate
    isRejected
    type
  }
}
}

Sortable fields: publishedTime, organizationId. Filterable fields: publishedTime, organizationId.

Get a bank report by ID​

Note that bankReportById returns a list ([bankReport!]!) — usually with one or zero elements. Treat the result as an array.

query getBankReportById($id: UUID!) {
bankReportById(id: $id) {
  id
  publishedTime
  finishedDate
  isRejected
  rejectedReason
  type
}
}

If the report belongs to a different bank or has been cancelled, the list is empty.

Expand the package contents​

A bank report wraps a lot of related entities. Pull only the slices you need; project deeper sub‑components from the dedicated guide pages.

query bankReportContents($id: UUID!) {
bankReportById(id: $id) {
  id
  publishedTime
  type
  organization {
    id
    name
    vatNumber
  }
  isStatutesRequired
  isAccountingRequired
  isAdministratorsRequired
  isTaxResidencyRequired
}
}

For the full set of fields available on bankReport, browse the live schema in /graphql.

Filter by organization​

To pull every report for a single organization, filter on organizationId.

query reportsForOrganization($organizationId: UUID!) {
bankReports(where: { organizationId: { eq: $organizationId } }, order: [{ publishedTime: DESC }], first: 20) {
  nodes {
    id
    publishedTime
    isRejected
  }
}
}

Filter by date range​

publishedTime accepts the standard date operators (gte, lt, gt, lte, eq, neq). Combine with and to build a window.

query reportsInWindow($from: DateTime!, $to: DateTime!) {
bankReports(
  where: { and: [
    { publishedTime: { gte: $from } }
    { publishedTime: { lt: $to } }
  ] }
  order: [{ publishedTime: DESC }]
  first: 50
) {
  totalCount
  nodes {
    id
    publishedTime
    isRejected
    type
  }
}
}

Combine bank info with reports in one request​

GraphQL lets you batch unrelated reads. Pulling the bank's name alongside its latest reports avoids a round‑trip on first page load.

query bankOverviewWithRecentReports($first: Int) {
bank {
  id
  name
}
bankReports(order: [{ publishedTime: DESC }], first: $first) {
  totalCount
  nodes {
    id
    publishedTime
    isRejected
    type
  }
}
}