PRH Open Data (Finland)

PRH Open Data (Finland) Publicnotices API

The Publicnotices API from PRH Open Data (Finland) — 1 operation(s) for publicnotices.

Documentation GitHub OpenAPI

Operations 1

GET /publicnotices/{recordYear}/{recordNumber} Search for registered notifications by record number #

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/avoindata-prh-fi:avoindata-prh-fi-publicnotices-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: Avoindata Prh Fi Publicnotices API
  version: 2.0
  license:
    name: Creative Commons Nimeä 4.0
    url: https://creativecommons.org/licenses/by/4.0/
  description: 'Operations tagged Publicnotices across 2 of this provider''s published API definitions: avoindata-prh-fi-registerednotices-openapi-original.yml, avoindata-prh-fi-registerednotices-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://avoindata.prh.fi/opendata-registerednotices-api/v3
tags:
- name: Publicnotices
paths:
  /publicnotices/{recordYear}/{recordNumber}:
    get:
      summary: Search for registered notifications by record number
      operationId: GetPublicNotices
      parameters:
      - in: path
        name: recordYear
        required: true
        description: A year of record number
        schema:
          type: integer
          format: int32
      - in: path
        name: recordNumber
        required: true
        description: A record number
        schema:
          type: string
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompanyPublicNotice'
        400:
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        429:
          description: Too many requests
          content:
            text/plain:
              schema:
                type: string
        500:
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        503:
          description: The server cannot process the request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Publicnotices
    servers:
    - url: https://avoindata.prh.fi/opendata-registerednotices-api/v3
components:
  schemas:
    ErrorResponse:
      type: object
      required:
      - timestamp
      - code
      description: Error message
      properties:
        timestamp:
          type: string
          minLength: 19
          maxLength: 19
          format: date-time
          x-field-extra-annotation: '@com.fasterxml.jackson.annotation.JsonFormat(shape = com.fasterxml.jackson.annotation.JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss")'
          description: Time, including seconds, without a time zone in the format ‘YYYY-MM-DD 00:00:00'
        message:
          type: string
          description: Error message
          maxLength: 1000
        errorcode:
          type: integer
          format: int32
          description: Error code
    CompanyPublicNotice:
      type: object
      required:
      - businessId
      - recordNumber
      description: ''
      properties:
        businessId:
          type: string
          description: A Business ID of company
        registrationDate:
          type: string
          format: date
          description: Date of registration
        recordNumber:
          type: string
          description: Record number of entry
        typeOfRegistration:
          type: string
          description: Registration type of entry
        entryCodes:
          type: array
          description: Entry codes
          items:
            type: string
        companyDetailsUri:
          type: string
          description: A record URI for details
externalDocs:
  description: Find out more about the Swagger software
  url: http://swagger.io
x-refined-from:
- avoindata-prh-fi-registerednotices-openapi-original.yml
- avoindata-prh-fi-registerednotices-openapi.yml