Start here
This guide contains public integration notes for Guernsey. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.Guernsey coverage, pricing, and sources
Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.
Table of Contents
- Data Sources
- Company Identifiers
- Search Capabilities
- Quirks & Gotchas
- Mappings
- Data Availability
- Example API Responses
Data Sources
Guernsey uses a single official registry for all entity types. Data comes from the Guernsey Registry — there is no cross-registry merging.Commercial companies, partnerships & foundations
- Guernsey Registry — Operated by the Guernsey Financial Services Commission (GFSC) under the Companies (Guernsey) Law, 2008. The Registry Portal at
portal.guernseyregistry.comprovides a public API covering companies (Non-Cellular, Protected Cell, Incorporated Cell), Limited Partnerships, Limited Liability Partnerships, and Foundations. This is the sole source for all structured entity data: company name, legal form, status, incorporation date, registered address, economic activity, directors, and other officials.
Charities & non-profits
- Guernsey Registry — Charities and Non-Profit Organisations are registered through the same Registry Portal under the Charities and Non Profit Organisations (Registration) (Guernsey) Law, 2008. The API exposes the same endpoints for these entity types, including officer data (Chairperson, Treasurer, Secretary) and available documents.
All Guernsey Registry data is publicly available without authentication. The API has a rate limit of 60 requests per minute.
How does the data flow work?
How does the data flow work?
For each company profile request, the system aggregates data from five Guernsey Registry API endpoints in parallel:
- Public Search — Basic company data (name, status, entity type, registration number)
- Entity Details — Registered address, registration date, contact info
- Extended Details — Economic activity code and classification
- Events — Filing history (used to extract incorporation date)
- Name History — Previous/former names
- Relationships — Directors, Resident Agents, General Partners, Councillors, etc.
Company Identifiers
Query Identifiers
Guernsey entities are identified using a registration number prefixed by the entity type:Identifiers in API Response
Guernsey entities do not have VAT numbers, SIREN equivalents, or other secondary identifiers. The registration number is the only public identifier.
Search Capabilities
Search uses live Registry API lookups. Both name and identifier searches query the Guernsey Registry’s public-search endpoint in real time. Name searches accept free text with a minimum of 2 characters and a maximum of 100 characters.
Quirks & Gotchas
Statutory Filings
Guernsey companies file an annual validation, the local equivalent of a confirmation statement, confirming the entity’s particulars are current. The Registry publishes the date it next falls due, returned on the cross-countrystatutoryFilings field.
next.dueDate is populated. Guernsey companies file no public financial statements, so there is no accounts obligation to report.
See Compliance Signals & Statutory Filings for the full field reference.
Mappings
Company Status
Company status is extracted from the Guernsey Registry’sentityStatusDesc field. The active flag is determined deterministically from a known list of active statuses. The standardized status (statusDetails) is AI-enriched.
Active Statuses
At-Risk Statuses
Winding Up Statuses
Inactive / Closed Statuses
Dissolved Statuses
Legal Forms
Guernsey uses entity type IDs from the Registry API. The entity type set is closed and statutory, so the local name, English name, standardized category and ISO 20275 (ELF) code are all mapped deterministically. No AI is involved in the legal form.Guernsey’s ISO 20275 vocabulary splits companies by liability (limited by
shares, limited by guarantee, mixed liability, unlimited), and each carries a
different ELF code. The Registry does not publish which of those a given
company is, so no ISO 20275 code is returned for the generic company types
rather than an inferred one.
Companies
Partnerships
Foundations & Non-Profits
Charities
Other Entity Types (not company profiles)
The local legal form name from the Registry is always preserved verbatim.
Legal Representatives
Legal representatives are extracted from the Guernsey Registry’s relationships endpoint. Classification is deterministic for known relationship types (no AI needed). Both individuals and corporate entities can hold legal representative roles.Other Key Persons
Uncertain Roles (AI-parsed): The “Other Managing Official” role (relationship type ID 123, always individual) is ambiguous. For charities/NPOs, these are typically trustees with collective signing authority and are classified as Legal Representatives by AI. For companies, they are usually classified as Other Key Persons unless they have explicit signing authority.
Structural Relationships (excluded from key persons)
The following relationship types appear in the API but are not mapped to key persons:Shareholders
Activity Code Mapping
Guernsey uses its own GFSC economic activity classification with dotted numeric codes (e.g.,10.5.7, 02.9.1). These codes do not directly map to European or international standards. NACE and ISIC codes are always AI-inferred from the activity description text.
Some entities have
NA as their economic activity classification, indicating no specific activity has been assigned. In these cases, no activity codes are returned. Both NACE and ISIC codes are always AI-inferred for Guernsey entities — check the isAIInferred flag.Data Availability
Data Availability Matrix
Legend: ✅ Available | ❌ Not Available | Async = Asynchronous processing
Documents by Company Type
Document catalog items:
GGY_TRADE_REGISTER_EXTRACT— Paid Statement of Register for commercial entities (CMP, LP, LLP, FND)GGY_TRADE_REGISTER_EXTRACT_CHARITY_NONPROFIT— Free Statement for charities/NPOsGGY_CERTIFICATE_OF_GOOD_STANDING— Certificate of Good Standing (active entities only)GGY_CERTIFICATE_OF_INCORPORATION— Historical certificate of incorporationGGY_ARTICLE_OF_ASSOCIATION— Articles/Memorandum of AssociationGGY_FILED_DOCUMENT— All other filed documents (Annual Validations, Resolutions, etc.)
Example API Responses
All examples use placeholder data. Query:POST /v2/company with { "id": "<id>", "countryCode": "GG", "dataPoints": ["company", "legalRepresentatives"] }
Active Non-Cellular Company with Corporate Directors (CMP)
Active Non-Cellular Company with Corporate Directors (CMP)
Dissolved Company with Previous Names (CMP)
Dissolved Company with Previous Names (CMP)
legacyLegalNames when previous names exist. Officials data is typically empty for dissolved entities.Foundation with Councillors and Guardian (FND)
Foundation with Councillors and Guardian (FND)
Non-Profit Organisation with Chairperson, Treasurer, Secretary (NP)
Non-Profit Organisation with Chairperson, Treasurer, Secretary (NP)
Charity with Corporate Director (CH)
Charity with Corporate Director (CH)
Available Documents (Company example)
Available Documents (Company example)
Documents are returned when
"dataPoints": ["availableDocuments"] is requested.Commercial entities (CMP, LP, LLP, FND):Charities and Non-Profits (CH, NP):