API
Real Estate Price Register
Public transaction and property information from the Real Estate Price Register.
Documentation
The service provides searchable transactions and their related properties from the Real Estate Price Register. Transaction information includes the structured IdRCN, document date, transaction and market types, party categories, gross price and VAT amount. Property details include parcels, buildings and units with their parameters, addresses and geometry.
API endpoints
GET
/transactions
Transactions
json
List bounded RCN transactions.
Data publication metadata
Try endpoint
Endpoint
/api/public/rcn/transactions?version=v1Parameters
| Name | Location | Type | Required | Description | example |
|---|---|---|---|---|---|
limit |
query | integer |
optional | Maximum number of records to return (at most 100). | 25 |
offset |
query | integer |
optional | Number of records to skip. | - |
transactionIdentifier |
query | string |
optional | Transaction identifier assigned in the register. | 2026/1 |
documentDateFrom |
query | string |
optional | Earliest document date in YYYY-MM-DD format. | 2026-01-01 |
documentDateTo |
query | string |
optional | Latest document date in YYYY-MM-DD format. | 2026-01-01 |
grossPriceFrom |
query | string |
optional | Minimum gross price. | 100000.00 |
grossPriceTo |
query | string |
optional | Maximum gross price. | 100000.00 |
transactionType |
query | integer |
optional | Transaction type code. | 1 |
marketType |
query | integer |
optional | Market type code. | 1 |
sellerPartyType |
query | integer |
optional | Seller party type code. | 1 |
buyerPartyType |
query | integer |
optional | Buyer party type code. | 1 |
Request
GET /api/public/rcn/transactions?limit=25&offset=0
Response
{
"items": [{
"uri": "https://data.example.test/api/public/rcn/transactions/TR_1",
"id": "TR_1",
"transactionGmlId": "TR_1",
"transactionIdentifier": "2026/1",
"idRCN": {"namespace": "PL.PZGiK.2661.RCN", "localId": "TR_1", "versionId": "2026-01-15T10:00:00Z"},
"legalBasisDocument": {"id": "DOC_1", "identifier": "Rep. A 123/2026", "date": "2026-01-15", "creator": "Kancelaria notarialna"},
"transactionType": {"code": 1, "value": "wolnyRynek", "termUri": "https://data.example.test/api/public/rcn/dictionaries/transaction-types#code-1"},
"marketType": {"code": 2, "value": "rynekWtorny", "termUri": "https://data.example.test/api/public/rcn/dictionaries/market-types#code-2"},
"sellerPartyType": {"code": 3, "value": "osobaFizyczna", "termUri": "https://data.example.test/api/public/rcn/dictionaries/party-types#code-3"},
"buyerPartyType": {"code": 3, "value": "osobaFizyczna", "termUri": "https://data.example.test/api/public/rcn/dictionaries/party-types#code-3"},
"grossPrice": "100000.00",
"vatAmount": null,
"currency": "PLN",
"properties": [{"propertyUri": "https://data.example.test/api/public/rcn/properties/PROP_1", "id": "PROP_1"}]
}],
"pagination": {"limit": 25, "offset": 0, "count": 1, "total": 1, "next": null}
}
GET
/transactions/{transactionGmlId}
Transaction
json
Return one RCN transaction and its property references.
Data publication metadata
Try endpoint
Endpoint
/api/public/rcn/transactions/{transactionGmlId}?version=v1Parameters
| Name | Location | Type | Required | Description | example |
|---|---|---|---|---|---|
transactionGmlId |
path | string |
required | Stable RCN transaction GML identifier. | TR_1 |
Request
GET /api/public/rcn/transactions/TR_1
Response
{
"uri": "https://data.example.test/api/public/rcn/transactions/TR_1",
"id": "TR_1",
"transactionGmlId": "TR_1",
"transactionIdentifier": "2026/1",
"idRCN": {"namespace": "PL.PZGiK.2661.RCN", "localId": "TR_1", "versionId": "2026-01-15T10:00:00Z"},
"legalBasisDocument": {"id": "DOC_1", "identifier": "Rep. A 123/2026", "date": "2026-01-15", "creator": "Kancelaria notarialna"},
"transactionType": {"code": 1, "value": "wolnyRynek", "termUri": "https://data.example.test/api/public/rcn/dictionaries/transaction-types#code-1"},
"marketType": {"code": 2, "value": "rynekWtorny", "termUri": "https://data.example.test/api/public/rcn/dictionaries/market-types#code-2"},
"sellerPartyType": {"code": 3, "value": "osobaFizyczna", "termUri": "https://data.example.test/api/public/rcn/dictionaries/party-types#code-3"},
"buyerPartyType": {"code": 3, "value": "osobaFizyczna", "termUri": "https://data.example.test/api/public/rcn/dictionaries/party-types#code-3"},
"grossPrice": "100000.00",
"vatAmount": null,
"currency": "PLN",
"properties": [{"propertyUri": "https://data.example.test/api/public/rcn/properties/PROP_1", "id": "PROP_1"}]
}
GET
/properties
Properties
json
List bounded RCN properties.
Data publication metadata
Try endpoint
Endpoint
/api/public/rcn/properties?version=v1Parameters
| Name | Location | Type | Required | Description | example |
|---|---|---|---|---|---|
limit |
query | integer |
optional | Maximum number of records to return (at most 100). | 25 |
offset |
query | integer |
optional | Number of records to skip. | - |
grossPriceFrom |
query | string |
optional | Minimum gross price. | 100000.00 |
grossPriceTo |
query | string |
optional | Maximum gross price. | 100000.00 |
landAreaFrom |
query | string |
optional | Minimum land area in m². | 100000.00 |
landAreaTo |
query | string |
optional | Maximum land area in m². | 100000.00 |
propertyType |
query | integer |
optional | Property type code. | 1 |
propertyRightType |
query | integer |
optional | Property right type code. | 1 |
transactionGmlId |
query | string |
optional | Stable RCN transaction GML identifier. | TR_1 |
parcelIdentifier |
query | string |
optional | Full cadastral parcel identifier. | 266101_1.0001.1 |
address |
query | string |
optional | Part of a locality, street or building number. | Kielce Krakowska 10 |
bbox |
query | string |
optional | EPSG:4326 bounding box as minLongitude,minLatitude,maxLongitude,maxLatitude. | 20.58,50.82,20.72,50.90 |
Request
GET /api/public/rcn/properties?limit=25&offset=0
Response
{
"items": [{
"uri": "https://data.example.test/api/public/rcn/properties/PROP_1",
"id": "PROP_1",
"propertyGmlId": "PROP_1",
"propertyType": {"code": 2, "value": "nieruchomoscGruntowaZabudowana", "termUri": "https://data.example.test/api/public/rcn/dictionaries/property-types#code-2"},
"propertyRightType": {"code": 1, "value": "wlasnoscNieruchomosciGruntowej", "termUri": "https://data.example.test/api/public/rcn/dictionaries/property-right-types#code-1"},
"propertyRightShare": "1/1",
"landAreaM2": "1234.0000",
"grossPrice": "100000.00",
"currency": "PLN",
"transactions": [{"transactionUri": "https://data.example.test/api/public/rcn/transactions/TR_1", "id": "TR_1"}]
}],
"pagination": {"limit": 25, "offset": 0, "count": 1, "total": 1, "next": null}
}
GET
/properties/{propertyGmlId}
Property
json
Return a property with its related transactions, parcels, buildings and units.
Data publication metadata
Try endpoint
Endpoint
/api/public/rcn/properties/{propertyGmlId}?version=v1Parameters
| Name | Location | Type | Required | Description | example |
|---|---|---|---|---|---|
propertyGmlId |
path | string |
required | Stable RCN property GML identifier. | PROP_1 |
Request
GET /api/public/rcn/properties/PROP_1
Response
{
"uri": "https://data.example.test/api/public/rcn/properties/PROP_1",
"id": "PROP_1",
"propertyGmlId": "PROP_1",
"propertyType": {"code": 2, "value": "nieruchomoscGruntowaZabudowana", "termUri": "https://data.example.test/api/public/rcn/dictionaries/property-types#code-2"},
"propertyRightType": {"code": 1, "value": "wlasnoscNieruchomosciGruntowej", "termUri": "https://data.example.test/api/public/rcn/dictionaries/property-right-types#code-1"},
"propertyRightShare": "1/1",
"landAreaM2": "1234.0000",
"grossPrice": "100000.00",
"currency": "PLN",
"transactions": [{"transactionUri": "https://data.example.test/api/public/rcn/transactions/TR_1", "id": "TR_1"}],
"parcels": [],
"buildings": [],
"units": []
}
GET
/dictionaries
Dictionaries
json
Return the dictionaries used by RCN data.
Data publication metadata
Try endpoint
Endpoint
/api/public/rcn/dictionaries?version=v1
GET
/dictionaries/transaction-types
Transaction types
json
Return codes, canonical values and labels from an RCN dictionary.
Data publication metadata
Try endpoint
Endpoint
/api/public/rcn/dictionaries/transaction-types?version=v1
GET
/dictionaries/market-types
Market types
json
Return codes, canonical values and labels from an RCN dictionary.
Data publication metadata
Try endpoint
Endpoint
/api/public/rcn/dictionaries/market-types?version=v1
GET
/dictionaries/party-types
Transaction party types
json
Return codes, canonical values and labels from an RCN dictionary.
Data publication metadata
Try endpoint
Endpoint
/api/public/rcn/dictionaries/party-types?version=v1
GET
/dictionaries/property-types
Property types
json
Return codes, canonical values and labels from an RCN dictionary.
Data publication metadata
Try endpoint
Endpoint
/api/public/rcn/dictionaries/property-types?version=v1
GET
/dictionaries/property-right-types
Property right types
json
Return codes, canonical values and labels from an RCN dictionary.
Data publication metadata
Try endpoint
Endpoint
/api/public/rcn/dictionaries/property-right-types?version=v1
GET
/dictionaries/land-uses
Land uses
json
Return codes, canonical values and labels from an RCN dictionary.
Data publication metadata
Try endpoint
Endpoint
/api/public/rcn/dictionaries/land-uses?version=v1
GET
/dictionaries/local-plan-designations
Local plan designations
json
Return codes, canonical values and labels from an RCN dictionary.
Data publication metadata
Try endpoint
Endpoint
/api/public/rcn/dictionaries/local-plan-designations?version=v1
GET
/dictionaries/building-types
Building types
json
Return codes, canonical values and labels from an RCN dictionary.
Data publication metadata
Try endpoint
Endpoint
/api/public/rcn/dictionaries/building-types?version=v1
GET
/dictionaries/unit-functions
Unit functions
json
Return codes, canonical values and labels from an RCN dictionary.
Data publication metadata
Try endpoint
Endpoint
/api/public/rcn/dictionaries/unit-functions?version=v1