search_archives

Search Arkivportalen, the national archive catalogue: fonds, series and units held by Norwegian archive institutions (statsarkiv, byarkiv, private archives, ...).

Signature: search_archives(query: string, required; limit: integer, items, optional, default 25; page: integer, optional, default 1; offset: integer, items, optional, default 0)

Direct GET

For navigating agents: open the HTML page with parameters in the URL. The result is fetched and displayed without screenshots or form filling.

Open this validated HTML GET URL

https://allemannsdata.com/wiki/kilder/arkivverket/search_archives/?query={query}&limit=25&page=1&offset=0

Replace {query}, {limit}, {page} with values. Remove unused optional parameters from the URL.

For software and dashboards: Read the operation descriptor. The JSON GET template is https://allemannsdata.com/wiki/api/v1/kilder/arkivverket/search_archives?query={query}&limit=25&page=1&offset=0. Open this exact request as JSON.

ParameterRequirementJSON typeDescription
queryrequiredstringFree-text search, e.g. an organisation, topic or place.
limitoptionalintegerResults per page, 1-100 (default 25). Unit: items.
pageoptionalintegerPage number, 1-based (default 1).
offsetoptionalintegerNumber of list items to skip; default 0.
Generated JavaScript, Python and response structure

Use JSON when the user requests code, machine-readable data, value extraction or further computation. Use the HTML GET page to identify the correct source and verify parameters.

Example for generated JavaScript and Python

https://allemannsdata.com/wiki/api/v1/kilder/arkivverket/search_archives?query={query}&limit=25&page=1&offset=0

Replace URL placeholders and remove unused optional parameters.

JavaScript in a dashboard

const url = "https://allemannsdata.com/wiki/api/v1/kilder/arkivverket/search_archives?query={query}&limit=25&page=1&offset=0";
const response = await fetch(url);
if (!response.ok) {
  const failure = await response.json();
  throw new Error(`${failure.error.code}: ${failure.error.message} ${failure.suggestion}`);
}
const result = await response.json();
const data = result.data;

Python without additional packages

import json
from urllib.request import urlopen

url = "https://allemannsdata.com/wiki/api/v1/kilder/arkivverket/search_archives?query={query}&limit=25&page=1&offset=0"
with urlopen(url) as response:
    result = json.load(response)
data = result["data"]

Response structure

{
  "source": "arkivverket",
  "operation": "search_archives",
  "parameters": {},
  "data": {},
  "entities": [],
  "_meta": {"retrieved_at": "...", "sources": [], "cache": {}},
  "_links": {"self": "...", "source": "...", "wiki": "...", "feedback": "..."}
}
Form for manual use

The form is a fallback for people and browser agents that cannot open the GET URL directly.

Type: string. Free-text search, e.g. an organisation, topic or place.
Type: integer. Results per page, 1-100 (default 25). Unit: items.
Type: integer. Page number, 1-based (default 1).

Result

Source: National Archives of Norway. Retrieved 2026-10-23T22:59:30Z in 2.324 seconds.

Showing 5 of 5 results in compact format.

  1. name:
    Capgemini
    id:
    0010
  2. name:
    Avtaledokument. Tredjepartsverifikasjon IKT. Capgemini Norge as
    id:
    0001
  3. name:
    Kontrakt 720-8001, tredjepartsverifikasjon IKT, Capgemini Norge as
    id:
    0002
  4. name:
    EØS 027 - 2007 Vikarsystem og turnussystem - kopi
    id:
    0001
  5. name:
    Elektronisk dokumenthåndtering system 2006
    id:
    L0252
Show all fields in HTML
total:
5
total_exact:
yes
returned:
5
page:
1
results:

5 results

  1. urn:
    150472f7-630d-4881-a33a-25343e22a813
    name:
    Capgemini
    id:
    0010
    path:
    VID/MDA-A-5024/V/Va/0001/0005/0010
    unit_type:
    MAPPE
    institution:
    Misjons- og diakoniarkivet, VID
    digitized_documents:
    0
    link:
    https://www.arkivportalen.no/entity/150472f7-630d-4881-a33a-25343e22a813
  2. urn:
    ea3a9d99-af3a-4de8-a458-4c18b2f877a4
    name:
    Avtaledokument. Tredjepartsverifikasjon IKT. Capgemini Norge as
    id:
    0001
    path:
    AV/SAT-A-1581/F/Fa/Far/L0031/0001
    unit_type:
    MAPPE
    institution:
    Nasjonalarkivet
    digitized_documents:
    0
    link:
    https://www.arkivportalen.no/entity/ea3a9d99-af3a-4de8-a458-4c18b2f877a4
  3. urn:
    5cc7b93d-4044-4850-b9fb-102eef04c7b7
    name:
    Kontrakt 720-8001, tredjepartsverifikasjon IKT, Capgemini Norge as
    id:
    0002
    path:
    AV/SAT-A-1581/D/Da/L0444/0002
    unit_type:
    MAPPE
    institution:
    Nasjonalarkivet
    country:
    norge
    digitized_documents:
    0
    link:
    https://www.arkivportalen.no/entity/5cc7b93d-4044-4850-b9fb-102eef04c7b7
  4. urn:
    no-BBA_arkiv000000259668
    name:
    EØS 027 - 2007 Vikarsystem og turnussystem - kopi
    id:
    0001
    path:
    BBA/A-5166/F/Fb/L0008/0001
    unit_type:
    Mappe
    institution:
    Bergen byarkiv
    digitized_documents:
    0
    link:
    https://www.arkivportalen.no/entity/no-BBA_arkiv000000259668
  5. urn:
    43fd27ea-6365-4934-bca8-2b344ce1ec7a
    name:
    Elektronisk dokumenthåndtering system 2006
    id:
    L0252
    path:
    AV/RA-PA-0250/D/Db/L0252
    unit_type:
    STYKKE
    institution:
    Nasjonalarkivet
    country:
    norge
    digitized_documents:
    0
    link:
    https://www.arkivportalen.no/entity/43fd27ea-6365-4934-bca8-2b344ce1ec7a
limit:
25
offset:
0
has_more_results:
no
Will you use the result in generated code?

Open the same result as JSON

Is data missing or incorrect? Send feedback about this result.

Continue exploring

How an AI agent should use this page

Ground rule: Navigate with HTML GET links to keep explanations and relationships. Use the page's JSON alternative only when concrete values must be extracted, compared or computed.

How to use the search_archives lookup

  1. Replace the placeholders in the HTML GET template; remove optional parameters you do not need.
  2. Check types, units, limits and ID formats in the parameter table.
  3. Follow linked results to canonical pages before combining sources.

Misreading to avoid: An empty list means "no results for this lookup". An error message or unavailable source does not mean the data does not exist.

Source-specific next step

Go to the source page for other operations. Use the JSON template only after the HTML result shows that the parameters and source are correct.