Country reference data.
Countries
A country referenced for nationality, tax residency, and threat-level classification.
Fields
Fields on the Country object.
| Field | Type | Description |
|---|---|---|
id | ID! | — |
createdAt | Time! | — |
deletedAt | Time | Soft-delete timestamp. Null when the record is active. |
codeAlpha2 | String! | ISO 3166-1 alpha-2 code (e.g., "FR"). |
codeAlpha3 | String! | ISO 3166-1 alpha-3 code (e.g., "FRA"). |
nationalityThreatLevel | CountryThreatLevel | AML/CFT threat level assigned to this country when used as a nationality. Null when not yet classified. |
taxResidencyThreatLevel | CountryThreatLevel | AML/CFT threat level assigned to this country when used as a tax residency. Null when not yet classified. |
Queries
Root queries that return or operate on this object.
country
countryRetrieve a single country by its ID.
type Query {
country(id: ID!): Country
}Arguments
| Argument | Type | Description |
|---|---|---|
id | ID! | — |
Returns
countries
countriesList countries with pagination, optionally filtered by user context.
type Query {
countries(first: Int, last: Int, before: String, after: String, userID: ID): CountryConnection!
}Arguments
Returns
Related types
Supporting objects, inputs, and enums used by this page.
Objects
CountryConnection
CountryConnectionType: object
Relay connection for paginated Country results.
Fields
| Field | Type | Description |
|---|---|---|
nodes | [Country]! | — |
edges | [CountryEdge!]! | — |
pageInfo | PageInfo! | — |
totalCount | Int! | — |
CountryEdge
CountryEdgeType: object
Relay edge wrapping a Country node with its pagination cursor.
Fields
Enums
CountryThreatLevel
CountryThreatLevelType: enum
AML/CFT threat level assigned to a country for risk-scoring purposes.
Values
| Value | Description |
|---|---|
LOW | |
MEDIUM | |
HIGH | |
CRITICAL |

