Suomi.fi · Schema
OrganizationResponse
Organization response
GovernmentFinlandPublic SectorDigital IdentityService CatalogueOpen DataX-Road
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/suomi-fi/json-schema/suomi-fi-organization-response-schema.json",
"title": "OrganizationResponse",
"description": "Organization response",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/suomi-fi-ptv-openapi.yml#/components/schemas/OrganizationResponse",
"type": "object",
"required": [
"organizationType"
],
"oneOf": [
{
"$ref": "#/$defs/StateOrganizationResponse"
},
{
"$ref": "#/$defs/MunicipalityOrganizationResponse"
},
{
"$ref": "#/$defs/RegionalOrganizationResponse"
},
{
"$ref": "#/$defs/NonProfitOrganizationResponse"
},
{
"$ref": "#/$defs/CompanyOrganizationResponse"
}
],
"$defs": {
"AddressSourceResponse": {
"description": "Address source response",
"type": "object",
"required": [
"source"
],
"oneOf": [
{
"$ref": "#/$defs/UserEnteredAddressSourceResponse"
},
{
"$ref": "#/$defs/PostiAddressSourceResponse"
}
],
"title": "AddressSourceResponse"
},
"AreaTypesResponse": {
"description": "One of area types",
"type": "object",
"required": [
"areaType"
],
"oneOf": [
{
"$ref": "#/$defs/WholeCountry"
},
{
"$ref": "#/$defs/WholeCountryExceptAland"
},
{
"$ref": "#/$defs/LimitedArea"
}
],
"title": "AreaTypesResponse"
},
"CompanyOrganizationResponse": {
"type": "object",
"required": [
"contentId",
"parentOrganizationContentId",
"languageVersions",
"businessId",
"oid",
"eInvoiceAddresses",
"publishedAt",
"contactAddresses",
"location",
"contactMethodPriority",
"organizationType",
"area"
],
"properties": {
"migratedAt": {
"anyOf": [
{
"$ref": "#/$defs/DateTime"
},
{
"type": "null"
}
]
},
"contentId": {
"$ref": "#/$defs/ContentIdType"
},
"parentOrganizationContentId": {
"anyOf": [
{
"$ref": "#/$defs/ContentIdType"
},
{
"type": "null"
}
]
},
"languageVersions": {
"$ref": "#/$defs/LocalizedOrganizationLanguageVersionsResponse"
},
"businessId": {
"type": "string"
},
"oid": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"eInvoiceAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/EInvoiceAddressResponse"
}
},
"publishedAt": {
"anyOf": [
{
"$ref": "#/$defs/DateTime"
},
{
"type": "null"
}
]
},
"contactAddresses": {
"type": "object",
"required": [
"foreignAddresses",
"postOfficeBoxAddresses",
"streetAddresses"
],
"properties": {
"foreignAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/ForeignAddressResponse"
}
},
"postOfficeBoxAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/PostOfficeBoxAddressResponse"
}
},
"streetAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/StreetAddressResponse"
}
}
},
"additionalProperties": false
},
"location": {
"type": "object",
"required": [
"foreignAddresses",
"otherAddresses",
"streetAddresses"
],
"properties": {
"foreignAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/ForeignAddressResponse"
}
},
"otherAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/OtherAddressResponse"
}
},
"streetAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/StreetAddressResponse"
}
}
}
},
"contactMethodPriority": {
"$ref": "#/$defs/OrganizationContactMethodPriorityResponse"
},
"organizationType": {
"type": "string",
"enum": [
"Company"
]
},
"area": {
"$ref": "#/$defs/AreaTypesResponse"
}
},
"description": "Company organization response",
"title": "Company"
},
"ContentIdType": {
"type": "string",
"format": "uuid",
"description": "Content id type",
"title": "ContentIdType"
},
"CoordinateResponse": {
"type": "object",
"required": [
"system",
"source",
"easting",
"northing"
],
"properties": {
"system": {
"enum": [
"EPSG:3067",
"Unknown"
],
"type": "string"
},
"source": {
"enum": [
"NLS",
"User",
"AccessibilityRegister"
],
"type": "string"
},
"easting": {
"type": "number"
},
"northing": {
"type": "number"
}
},
"description": "Coordinate",
"title": "CoordinateResponse"
},
"DateTime": {
"type": "string",
"format": "date-time",
"description": "string, e.g. 2025-09-22T07:32:52.026Z",
"title": "DateTime"
},
"DomesticPhoneNumberResponse": {
"type": "object",
"required": [
"additionalInformation",
"chargeDescription",
"chargeType",
"number",
"type"
],
"properties": {
"additionalInformation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"chargeDescription": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"chargeType": {
"$ref": "#/$defs/PhoneChargeType"
},
"number": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"DomesticPhone"
]
}
},
"description": "Domestic phone number",
"additionalProperties": false,
"title": "DomesticPhoneNumberResponse"
},
"EInvoiceAddressResponse": {
"type": "object",
"required": [
"address",
"intermediatorCode",
"additionalInformation"
],
"properties": {
"address": {
"type": "string"
},
"intermediatorCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"additionalInformation": {
"type": "object",
"properties": {
"fi": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sv": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"en": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"se": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"smn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sms": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false,
"description": "E-invoice address",
"title": "EInvoiceAddressResponse"
},
"ForeignAddressResponse": {
"type": "object",
"required": [
"address",
"countryCode"
],
"properties": {
"address": {
"type": "object",
"properties": {
"fi": {
"type": "string"
},
"sv": {
"type": "string"
},
"en": {
"type": "string"
},
"se": {
"type": "string"
},
"smn": {
"type": "string"
},
"sms": {
"type": "string"
}
},
"additionalProperties": false
},
"countryCode": {
"type": "string"
}
},
"description": "Foreign address",
"title": "ForeignAddressResponse"
},
"InternationalPhoneNumberResponse": {
"type": "object",
"required": [
"dialCode",
"additionalInformation",
"chargeDescription",
"chargeType",
"number",
"type"
],
"properties": {
"dialCode": {
"type": "string"
},
"additionalInformation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"chargeDescription": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"chargeType": {
"$ref": "#/$defs/PhoneChargeType"
},
"number": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"InternationalPhone"
]
}
},
"description": "International phone number",
"additionalProperties": false,
"title": "InternationalPhoneNumberResponse"
},
"LimitedArea": {
"type": "object",
"required": [
"areaType",
"municipalities",
"regions",
"wellbeingServicesCounties"
],
"properties": {
"areaType": {
"type": "string",
"title": "LimitedArea",
"enum": [
"LimitedArea"
]
},
"municipalities": {
"type": "array",
"items": {
"type": "string"
}
},
"regions": {
"type": "array",
"items": {
"type": "string"
}
},
"wellbeingServicesCounties": {
"type": "array",
"items": {
"type": "string"
}
}
},
"title": "LimitedArea",
"description": "Limited area"
},
"LocalizedOrganizationLanguageVersionsResponse": {
"type": "object",
"properties": {
"fi": {
"$ref": "#/$defs/OrganizationResponseLanguageVersion"
},
"sv": {
"$ref": "#/$defs/OrganizationResponseLanguageVersion"
},
"en": {
"$ref": "#/$defs/OrganizationResponseLanguageVersion"
},
"se": {
"$ref": "#/$defs/OrganizationResponseLanguageVersion"
},
"smn": {
"$ref": "#/$defs/OrganizationResponseLanguageVersion"
},
"sms": {
"$ref": "#/$defs/OrganizationResponseLanguageVersion"
}
},
"additionalProperties": false,
"description": "Localized organization language versions",
"title": "LocalizedOrganizationLanguageVersionsResponse"
},
"MunicipalityOrganizationResponse": {
"type": "object",
"required": [
"contentId",
"parentOrganizationContentId",
"languageVersions",
"businessId",
"oid",
"eInvoiceAddresses",
"publishedAt",
"contactAddresses",
"location",
"contactMethodPriority",
"organizationType",
"area"
],
"properties": {
"migratedAt": {
"anyOf": [
{
"$ref": "#/$defs/DateTime"
},
{
"type": "null"
}
]
},
"contentId": {
"$ref": "#/$defs/ContentIdType"
},
"parentOrganizationContentId": {
"anyOf": [
{
"$ref": "#/$defs/ContentIdType"
},
{
"type": "null"
}
]
},
"languageVersions": {
"$ref": "#/$defs/LocalizedOrganizationLanguageVersionsResponse"
},
"businessId": {
"type": "string"
},
"oid": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"eInvoiceAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/EInvoiceAddressResponse"
}
},
"publishedAt": {
"anyOf": [
{
"$ref": "#/$defs/DateTime"
},
{
"type": "null"
}
]
},
"contactAddresses": {
"type": "object",
"required": [
"foreignAddresses",
"postOfficeBoxAddresses",
"streetAddresses"
],
"properties": {
"foreignAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/ForeignAddressResponse"
}
},
"postOfficeBoxAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/PostOfficeBoxAddressResponse"
}
},
"streetAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/StreetAddressResponse"
}
}
},
"additionalProperties": false
},
"location": {
"type": "object",
"required": [
"foreignAddresses",
"otherAddresses",
"streetAddresses"
],
"properties": {
"foreignAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/ForeignAddressResponse"
}
},
"otherAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/OtherAddressResponse"
}
},
"streetAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/StreetAddressResponse"
}
}
}
},
"contactMethodPriority": {
"$ref": "#/$defs/OrganizationContactMethodPriorityResponse"
},
"organizationType": {
"type": "string",
"enum": [
"Municipality"
]
},
"area": {
"type": "object",
"required": [
"areaType",
"municipalities"
],
"properties": {
"areaType": {
"type": "string",
"title": "LimitedArea",
"enum": [
"LimitedArea"
]
},
"municipalities": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"maxItems": 1
}
},
"description": "Municipality organization area",
"title": "LimitedArea"
}
},
"description": "Municipality organization response",
"title": "Municipality"
},
"NonProfitOrganizationResponse": {
"type": "object",
"required": [
"contentId",
"parentOrganizationContentId",
"languageVersions",
"businessId",
"oid",
"eInvoiceAddresses",
"publishedAt",
"contactAddresses",
"location",
"contactMethodPriority",
"organizationType",
"area"
],
"properties": {
"migratedAt": {
"anyOf": [
{
"$ref": "#/$defs/DateTime"
},
{
"type": "null"
}
]
},
"contentId": {
"$ref": "#/$defs/ContentIdType"
},
"parentOrganizationContentId": {
"anyOf": [
{
"$ref": "#/$defs/ContentIdType"
},
{
"type": "null"
}
]
},
"languageVersions": {
"$ref": "#/$defs/LocalizedOrganizationLanguageVersionsResponse"
},
"businessId": {
"type": "string"
},
"oid": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"eInvoiceAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/EInvoiceAddressResponse"
}
},
"publishedAt": {
"anyOf": [
{
"$ref": "#/$defs/DateTime"
},
{
"type": "null"
}
]
},
"contactAddresses": {
"type": "object",
"required": [
"foreignAddresses",
"postOfficeBoxAddresses",
"streetAddresses"
],
"properties": {
"foreignAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/ForeignAddressResponse"
}
},
"postOfficeBoxAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/PostOfficeBoxAddressResponse"
}
},
"streetAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/StreetAddressResponse"
}
}
},
"additionalProperties": false
},
"location": {
"type": "object",
"required": [
"foreignAddresses",
"otherAddresses",
"streetAddresses"
],
"properties": {
"foreignAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/ForeignAddressResponse"
}
},
"otherAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/OtherAddressResponse"
}
},
"streetAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/StreetAddressResponse"
}
}
}
},
"contactMethodPriority": {
"$ref": "#/$defs/OrganizationContactMethodPriorityResponse"
},
"organizationType": {
"type": "string",
"enum": [
"Organization"
]
},
"area": {
"$ref": "#/$defs/AreaTypesResponse"
}
},
"description": "Non profit organization response",
"title": "Organization"
},
"OrganizationContactMethodPriority": {
"description": "Organization Contact method priority",
"enum": [
"PostalAddress",
"PhoneNumber",
"Email",
"WebSite",
"EInvoiceAddress"
],
"type": "string",
"title": "OrganizationContactMethodPriority"
},
"OrganizationContactMethodPriorityResponse": {
"type": "array",
"items": {
"$ref": "#/$defs/OrganizationContactMethodPriority"
},
"description": "Organization contact method priority response",
"title": "OrganizationContactMethodPriorityResponse"
},
"OrganizationEmailAddressResponse": {
"type": "object",
"required": [
"email",
"additionalInformation"
],
"properties": {
"email": {
"type": "string"
},
"additionalInformation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false,
"description": "Email address",
"title": "OrganizationEmailAddressResponse"
},
"OrganizationResponseLanguageVersion": {
"type": "object",
"required": [
"name",
"alternativeName",
"isAlternativeNamePrimary",
"description",
"summary",
"contactEmails",
"contactWebPages",
"contactPhoneNumbers"
],
"properties": {
"name": {
"type": "string"
},
"alternativeName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"isAlternativeNamePrimary": {
"type": "boolean"
},
"description": {
"anyOf": [
{
"type": "string",
"description": "Markdown-formatted content. Use a Markdown parser/renderer when presenting it."
},
{
"type": "null"
}
]
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"contactEmails": {
"type": "array",
"items": {
"$ref": "#/$defs/OrganizationEmailAddressResponse"
}
},
"contactWebPages": {
"type": "array",
"items": {
"$ref": "#/$defs/WebPageResponse"
}
},
"contactPhoneNumbers": {
"type": "array",
"items": {
"$ref": "#/$defs/TelephoneNumberResponse"
}
}
},
"additionalProperties": false,
"description": "Organization response language version",
"title": "OrganizationResponseLanguageVersion"
},
"OtherAddressResponse": {
"type": "object",
"required": [
"postalCode",
"coordinates",
"additionalInformation"
],
"properties": {
"postalCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"coordinates": {
"type": "array",
"items": {
"$ref": "#/$defs/CoordinateResponse"
}
},
"additionalInformation": {
"type": "object",
"properties": {
"fi": {
"type": "string"
},
"sv": {
"type": "string"
},
"en": {
"type": "string"
},
"se": {
"type": "string"
},
"smn": {
"type": "string"
},
"sms": {
"type": "string"
}
},
"additionalProperties": false
}
},
"description": "Other address",
"title": "OtherAddressResponse"
},
"PhoneChargeType": {
"description": "Phone call charge type",
"enum": [
"Free",
"Charged",
"ExtraCharge"
],
"type": "string",
"title": "PhoneChargeType"
},
"PostOfficeBoxAddressResponse": {
"type": "object",
"required": [
"postalCode",
"postOfficeBox",
"additionalInformation"
],
"properties": {
"postalCode": {
"type": "string"
},
"postOfficeBox": {
"type": "object",
"properties": {
"fi": {
"type": "string"
},
"sv": {
"type": "string"
},
"en": {
"type": "string"
},
"se": {
"type": "string"
},
"smn": {
"type": "string"
},
"sms": {
"type": "string"
}
},
"additionalProperties": false
},
"additionalInformation": {
"type": "object",
"properties": {
"fi": {
"type": "string"
},
"sv": {
"type": "string"
},
"en": {
"type": "string"
},
"se": {
"type": "string"
},
"smn": {
"type": "string"
},
"sms": {
"type": "string"
}
},
"additionalProperties": false
}
},
"description": "Post office box address",
"title": "PostOfficeBoxAddressResponse"
},
"PostiAddressSourceResponse": {
"type": "object",
"required": [
"source"
],
"properties": {
"source": {
"type": "string",
"enum": [
"Posti"
]
}
},
"additionalProperties": false,
"description": "Posti address source",
"title": "PostiAddressSourceResponse"
},
"RegionalOrganizationResponse": {
"type": "object",
"required": [
"contentId",
"parentOrganizationContentId",
"languageVersions",
"businessId",
"oid",
"eInvoiceAddresses",
"publishedAt",
"contactAddresses",
"location",
"contactMethodPriority",
"organizationType",
"area"
],
"properties": {
"migratedAt": {
"anyOf": [
{
"$ref": "#/$defs/DateTime"
},
{
"type": "null"
}
]
},
"contentId": {
"$ref": "#/$defs/ContentIdType"
},
"parentOrganizationContentId": {
"anyOf": [
{
"$ref": "#/$defs/ContentIdType"
},
{
"type": "null"
}
]
},
"languageVersions": {
"$ref": "#/$defs/LocalizedOrganizationLanguageVersionsResponse"
},
"businessId": {
"type": "string"
},
"oid": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"eInvoiceAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/EInvoiceAddressResponse"
}
},
"publishedAt": {
"anyOf": [
{
"$ref": "#/$defs/DateTime"
},
{
"type": "null"
}
]
},
"contactAddresses": {
"type": "object",
"required": [
"foreignAddresses",
"postOfficeBoxAddresses",
"streetAddresses"
],
"properties": {
"foreignAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/ForeignAddressResponse"
}
},
"postOfficeBoxAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/PostOfficeBoxAddressResponse"
}
},
"streetAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/StreetAddressResponse"
}
}
},
"additionalProperties": false
},
"location": {
"type": "object",
"required": [
"foreignAddresses",
"otherAddresses",
"streetAddresses"
],
"properties": {
"foreignAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/ForeignAddressResponse"
}
},
"otherAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/OtherAddressResponse"
}
},
"streetAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/StreetAddressResponse"
}
}
}
},
"contactMethodPriority": {
"$ref": "#/$defs/OrganizationContactMethodPriorityResponse"
},
"organizationType": {
"type": "string",
"enum": [
"RegionalOrganization"
]
},
"area": {
"$ref": "#/$defs/LimitedArea"
}
},
"description": "Regional organization response",
"title": "RegionalOrganization"
},
"StateOrganizationResponse": {
"type": "object",
"required": [
"contentId",
"parentOrganizationContentId",
"languageVersions",
"businessId",
"oid",
"eInvoiceAddresses",
"publishedAt",
"contactAddresses",
"location",
"contactMethodPriority",
"organizationType",
"area"
],
"properties": {
"migratedAt": {
"anyOf": [
{
"$ref": "#/$defs/DateTime"
},
{
"type": "null"
}
]
},
"contentId": {
"$ref": "#/$defs/ContentIdType"
},
"parentOrganizationContentId": {
"anyOf": [
{
"$ref": "#/$defs/ContentIdType"
},
{
"type": "null"
}
]
},
"languageVersions": {
"$ref": "#/$defs/LocalizedOrganizationLanguageVersionsResponse"
},
"businessId": {
"type": "string"
},
"oid": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"eInvoiceAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/EInvoiceAddressResponse"
}
},
"publishedAt": {
"anyOf": [
{
"$ref": "#/$defs/DateTime"
},
{
"type": "null"
}
]
},
"contactAddresses": {
"type": "object",
"required": [
"foreignAddresses",
"postOfficeBoxAddresses",
"streetAddresses"
],
"properties": {
"foreignAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/ForeignAddressResponse"
}
},
"postOfficeBoxAddresses": {
"type": "array",
"items": {
"$ref": "#/$defs/PostOfficeBoxAddressResponse"
}
},
"streetAddresses": {
"type": "array",
"items": {
# --- truncated at 32 KB (37 KB total) ---
# Full source: https://artifacts.apis.io/suomi-fi/json-schema/suomi-fi-organization-response-schema.json
Work with this as data
Every JSON Schema 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 schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.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.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/suomi-fi-organization-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?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.
A second provider on the same verified email joins the account you already have.