University of Helsinki Named places API

The Named places API from University of Helsinki — 3 operation(s) for named places.

Operations 7

POST /named-places/{id}/reservation Reserve an existing named place #
DELETE /named-places/{id}/reservation Cancel a reservation for a named place #
GET /named-places Get a page of named places #
POST /named-places Create a new named place #
GET /named-places/{id} Get a named place by id #
PUT /named-places/{id} Update an existing named place #
DELETE /named-places/{id} Delete a named place #

Documentation

Specifications

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-hy-organisation-api-schemas.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-contact-search-api-schemas.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-course-pages-cms-schemas.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-helsinki-fi-content-schemas.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-hy-building-api-schemas.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-serviceapi-schemas.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-employeeinformationapi-schemas.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-persongroup-schemas.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-general-efecte-api-schemas.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-network-registry-api-schemas.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-finbif-laji-schemas.json

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/university-of-helsinki-named-places-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

university-of-helsinki-named-places-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Laji Named places API
  description: '## Authentication


    This API requires an **Access Token**.'
  version: '1'
  contact: {}
servers:
- url: https://api.laji.fi
tags:
- name: Named places
paths:
  /named-places/{id}/reservation:
    post:
      operationId: NamedPlacesController_reserve
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: personID
        required: false
        in: query
        description: Id for the person (your own id will be used if you are not admin)
        schema:
          type: string
      - name: until
        required: false
        in: query
        description: The date when the reservation expires
        schema:
          type: string
      - name: Person-Token
        required: false
        description: Person's authentication token. It is required.
        in: header
        schema:
          type: string
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/store-namedPlace'
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '403':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '406':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '422':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '500':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
      security:
      - Access token: []
      - Lang: []
      - Person token: []
      summary: Reserve an existing named place
      tags:
      - Named places
    delete:
      operationId: NamedPlacesController_cancelReservation
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: Person-Token
        required: false
        description: Person's authentication token. It is required.
        in: header
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/store-namedPlace'
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '403':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '406':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '422':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '500':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
      security:
      - Access token: []
      - Lang: []
      - Person token: []
      summary: Cancel a reservation for a named place
      tags:
      - Named places
  /named-places:
    get:
      operationId: NamedPlacesController_getPage
      parameters:
      - name: page
        required: false
        in: query
        schema:
          default: 1
          type: integer
      - name: pageSize
        required: false
        in: query
        schema:
          default: 20
          type: integer
      - name: idIn
        required: false
        in: query
        description: Include only items with these ids. Multiple values are separated by a comma (,).
        schema:
          type: string
      - name: alternativeIDs
        required: false
        in: query
        description: alternative ID. Multiple values are separated by a comma (,).
        schema:
          type: string
      - name: municipality
        required: false
        in: query
        description: municipality area code. Multiple values are separated by a comma (,).
        schema:
          type: string
      - name: birdAssociationArea
        required: false
        in: query
        description: bird association area code. Multiple values are separated by a comma (,).
        schema:
          type: string
      - name: selectedFields
        required: false
        in: query
        description: Return only selected fields per place. Multiple values are separated by a comma (,).
        schema:
          type: string
      - name: taxonIDs
        required: false
        in: query
        schema:
          type: string
      - name: tags
        required: false
        in: query
        description: Filter by tags. Multiple values are separated by a comma (,).
        schema:
          type: string
      - name: collectionID
        required: false
        in: query
        description: Collection id. Child collections are also fetched.
        schema:
          type: string
      - name: includePublic
        required: false
        in: query
        description: Include public named places (used only when Person-Token is given). Defaults to true.
        schema:
          default: true
          type: boolean
      - name: Person-Token
        required: false
        description: Person's authentication token. Necessary for fetching private places
        in: header
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  currentPage:
                    type: integer
                  pageSize:
                    type: integer
                  total:
                    type: integer
                  lastPage:
                    type: integer
                  prevPage:
                    type: integer
                  nextPage:
                    type: integer
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/store-namedPlace'
                required:
                - currentPage
                - pageSize
                - total
                - lastPage
                - results
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '403':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '406':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '422':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '500':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
      security:
      - Access token: []
      - Lang: []
      - Person token: []
      summary: Get a page of named places
      tags:
      - Named places
    post:
      operationId: NamedPlacesController_create
      parameters:
      - name: Person-Token
        required: false
        description: Person's authentication token. It is required.
        in: header
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/store-namedPlace'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/store-namedPlace'
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '403':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '406':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '422':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '500':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
      security:
      - Access token: []
      - Lang: []
      - Person token: []
      summary: Create a new named place
      tags:
      - Named places
  /named-places/{id}:
    get:
      operationId: NamedPlacesController_get
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: Person-Token
        required: false
        description: Person's authentication token. Necessary for fetching private places
        in: header
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/store-namedPlace'
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '403':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '406':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '422':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '500':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
      security:
      - Access token: []
      - Lang: []
      - Person token: []
      summary: Get a named place by id
      tags:
      - Named places
    put:
      operationId: NamedPlacesController_update
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: Person-Token
        required: false
        description: Person's authentication token. It is required.
        in: header
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/store-namedPlace'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/store-namedPlace'
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '403':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '406':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '422':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '500':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
      security:
      - Access token: []
      - Lang: []
      - Person token: []
      summary: Update an existing named place
      tags:
      - Named places
    delete:
      operationId: NamedPlacesController_delete
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: Person-Token
        required: false
        description: Person's authentication token. It is required.
        in: header
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StoreDeleteResponse'
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '403':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '406':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '422':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
        '500':
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                  localized:
                    type: boolean
      security:
      - Access token: []
      - Lang: []
      - Person token: []
      summary: Delete a named place
      tags:
      - Named places
components:
  schemas:
    store-preparation:
      type: object
      properties:
        '@context':
          type: string
          title: Context for the MF.preparationClass
        id:
          type: string
          title: Id for the MF.preparationClass
        '@type':
          type: string
          title: Type for the MF.preparationClass
        preparationDate:
          type: string
          description: Date when the preparation/sample was prepared.
          title: Preparation date
        preparationMaterials:
          type: array
          uniqueItems: false
          items:
            type: string
            enum:
            - ''
            - MF.preparationMaterialsAcetone
            - MF.preparationMaterialsAmmonia
            - MF.preparationMaterialsBasyntan
            - MF.preparationMaterialsBorax
            - MF.preparationMaterialsEulan
            - MF.preparationMaterialsHydrogenPeroxide
            - MF.preparationMaterialsMethyleneChloride
            - MF.preparationMaterialsNovaltan
            - MF.preparationMaterialsPapaine
            - MF.preparationMaterialsPlaster
            - MF.preparationMaterialsPolyurethane
            - MF.preparationMaterialsPretanix
            - MF.preparationMaterialsPurifiedGasoline
            - MF.preparationMaterialsWoodWool
            - MF.preparationMaterialsCTAB
            - MF.preparationMaterialsEZNAForensicKit
            - MF.preparationMaterialsDNEasyBloodAndTissueKit
            - MF.preparationMaterialsDNEasyPlantKit
            - MF.preparationMaterialsNucleospinTissueKit
            - MF.preparationMaterialsNucleospinPlantTwo
            - MF.preparationMaterialsSaltExtraction
            - MF.preparationMaterialsDNeasyPlantMiniKit
            - MF.preparationMaterialsMagAttractHMWDNAKit
          minItems: 0
          description: Materials (chemicals, kits etc.) used in the preparation process. It is possible to choose several.
          title: Preparation process materials
        preparationProcess:
          type: array
          uniqueItems: false
          items:
            type: string
            enum:
            - ''
            - MF.preparationProcessTanning
            - MF.preparationProcessEnzymaticMaceration
            - MF.preparationProcessDegreasing
            - MF.preparationProcessBeetleCleaning
            - MF.preparationProcessPEG
            - MF.preparationProcessFreezeDrying
          minItems: 0
          description: Processes used in the preparation. It is possible to choose several.
          title: Preparation process
        preparationProcessNotes:
          type: string
          description: Additional information about the preparation process.
          title: Preparation process notes
        preparedBy:
          type: string
          description: Name of the person who prepared the preparation/sample, preferably in the format 'lastname, firstname'
          title: Prepared by
        isPartOf:
          type: string
          description: Which parent or larger collection this is part of.
          title: Is part of
      additionalProperties: false
      required:
      - '@context'
      - id
      - '@type'
      - preparationDate
      - preparationMaterials
      - preparationProcess
      - preparationProcessNotes
      - preparedBy
      - isPartOf
    store-reserve:
      type: object
      properties:
        '@context':
          type: string
          title: Context for the MNP.reserveClass
        id:
          type: string
          title: Id for the MNP.reserveClass
        '@type':
          type: string
          title: Type for the MNP.reserveClass
        reserver:
          type: string
          title: Reserver
        until:
          type: string
          format: date
          title: Until
      required:
      - reserver
      - until
      additionalProperties: false
    store-namedPlace:
      type: object
      properties:
        '@context':
          type: string
          title: Context for the MNP.namedPlace
        id:
          type: string
          title: Id for the MNP.namedPlace
        '@type':
          type: string
          title: Type for the MNP.namedPlace
        acceptedDocument:
          $ref: '#/components/schemas/store-document'
        accessibility:
          type: string
          enum:
          - ''
          - MNP.accessibilityEasy
          - MNP.accessibilityModerate
          - MNP.accessibilityDifficult
          title: Accessibility
        active:
          $ref: '#/components/schemas/store-dateRange'
        alternativeIDs:
          type: array
          uniqueItems: false
          items:
            type: string
          minItems: 0
          title: Alternative IDs
        biogeographicalProvince:
          type: array
          uniqueItems: false
          items:
            type: string
          minItems: 0
          description: Formal abbreviation. For Finnish eliömaakunnat, use Finnish abbreviation.
          title: Biogeographical province
        birdAssociationArea:
          type: array
          uniqueItems: false
          items:
            type: string
          minItems: 0
          title: Bird assocation area
        collectionID:
          type: string
          title: Collection
        editors:
          type: array
          uniqueItems: false
          items:
            type: string
          minItems: 0
          description: Persons who have rights to see and use the named places in their documents
          title: Editors
        geometry:
          $ref: '#/components/schemas/store-geometry'
        images:
          type: array
          uniqueItems: false
          items:
            type: string
          minItems: 0
          title: Images
        locality:
          type: string
          title: Paikkatiedot
        localityDescription:
          type: string
          description: Informal description of the exact locality, e.g. '5 km NE of city X, under stone bridge'
          title: Locality description
        municipality:
          type: array
          uniqueItems: false
          items:
            type: string
          minItems: 0
          title: Municipality
        name:
          type: string
          title: Name
        notes:
          type: string
          title: Notes
        owners:
          type: array
          uniqueItems: false
          items:
            type: string
          minItems: 0
          description: Persons who have full use access and rights to edit the named place
          title: Owners of the named place
        prepopulatedDocument:
          $ref: '#/components/schemas/store-document'
        priority:
          type: string
          enum:
          - ''
          - MNP.priority1
          - MNP.priority2
          - MNP.priority3
          - MNP.priority4
          - MNP.priority5
          title: Priority
        privateNotes:
          type: string
          title: Private notes
        public:
          type: boolean
          description: Is the named place publicaly available. (Defaults to false)
          title: Publicly available
        reserve:
          $ref: '#/components/schemas/store-reserve'
        tags:
          type: array
          uniqueItems: false
          items:
            type: string
            enum:
            - ''
            - MNP.tagAccessibilityEasy
            - MNP.tagAccessibilityModerate
            - MNP.tagAccessibilityDifficult
            - MNP.tagHabitatImportant
            - MNP.tagCensusRare
            - MNP.tagHabitatFarmland
            - MNP.tagHabitatMire
            - MNP.tagHabitatMountain
            - MNP.tagSuitable
            - MNP.tagTypeIsland
            - MNP.tagTypePartialIsland
            - MNP.tagTypeIslandGroup
            - MNP.tagTypeWater
            - MNP.tagTypeShoreline
            - MNP.tagTypeMixed
            - MNP.tagTypeUnknown
            - MNP.tagWishedToBeCounted
          minItems: 0
          title: Tags
        taxonIDs:
          type: array
          uniqueItems: false
          items:
            type: string
          minItems: 0
          title: Taxa
        samplingMethodNotes:
          type: string
          title: Sampling method notes
      required:
      -

# --- truncated at 32 KB (200 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/openapi/university-of-helsinki-named-places-api-openapi.yml