{
"openapi": "3.0.1",
"info": {
"title": "France Condominium Registry - Syndics & Mandate End Dates",
"description": "Search the official French condominium registry (RNIC): condominiums with their professional syndic, mandate end date, lots and age. Daily data, no scraping.",
"version": "1.0",
"x-build-id": "KSvRhZyVs7aSGFRkk"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/eurodata-lab~france-condominium-registry/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-eurodata-lab-france-condominium-registry",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/eurodata-lab~france-condominium-registry/runs": {
"post": {
"operationId": "runs-sync-eurodata-lab-france-condominium-registry",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/eurodata-lab~france-condominium-registry/run-sync": {
"post": {
"operationId": "run-sync-eurodata-lab-france-condominium-registry",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"communeCodes": {
"title": "Commune INSEE codes",
"type": "array",
"description": "INSEE codes of the communes to search (5 characters, not the postal code), for example 74010 for Annecy or 33063 for Bordeaux. Paris (75056), Lyon (69123) and Marseille (13055) are expanded to all their arrondissements. Leave empty to search without a commune filter.",
"items": {
"type": "string"
},
"default": []
},
"postalCodes": {
"title": "Postal codes",
"type": "array",
"description": "Postal codes of the building's reference address (5 digits), for example 75011. Leave empty to search without a postal code filter.",
"items": {
"type": "string"
},
"default": []
},
"departmentCodes": {
"title": "Department codes",
"type": "array",
"description": "French department codes, for example 69, 2A or 974. Leave empty to search without a department filter.",
"items": {
"type": "string"
},
"default": []
},
"registrationNumbers": {
"title": "Registration numbers",
"maxItems": 10000,
"type": "array",
"description": "Registry numbers of specific condominiums (2 letters and 7 digits, for example AA2099810). Use it to refresh a list you already follow. Numbers not found are listed in the run log and are not billed.",
"items": {
"type": "string"
},
"default": []
},
"syndicType": {
"title": "Syndic type",
"enum": [
"any",
"professional",
"volunteer",
"none"
],
"type": "string",
"description": "Professional: managed by a professional property manager (company name and SIRET returned). Volunteer: managed by a co-owner (identity never returned). No syndic declared: no syndic recorded in the registry.",
"default": "any"
},
"syndicNameContains": {
"title": "Syndic name contains",
"type": "string",
"description": "Keep only condominiums whose professional syndic's company name contains this text (at least 3 characters, case-insensitive), for example FONCIA or NEXITY. Leave empty for all syndics.",
"default": ""
},
"syndicSiren": {
"title": "Syndic SIREN",
"type": "string",
"description": "Keep only condominiums managed by this professional syndic: 9-digit SIREN (or 14-digit SIRET). Handy to list a competitor's portfolio. Leave empty for all syndics.",
"default": ""
},
"mandateStatus": {
"title": "Mandate status",
"enum": [
"any",
"active",
"expiredNoSuccessor",
"expiredWithSuccessor",
"noMandate"
],
"type": "string",
"description": "Status of the syndic's mandate in the registry. Expired, no successor declared is a strong lead: the building may be looking for a new syndic.",
"default": "any"
},
"mandateEndFrom": {
"title": "Mandate ends on or after",
"type": "string",
"description": "Keep only condominiums whose last syndic mandate ends on or after this date. Enter a date (2026-12-31), \"today\", or a period relative to the run date such as \"+30 days\" or \"30 days ago\". Leave empty for no lower bound.",
"default": ""
},
"mandateEndTo": {
"title": "Mandate ends on or before",
"type": "string",
"description": "Keep only condominiums whose last syndic mandate ends on or before this date. Enter a date (2027-06-30) or a relative period such as \"in 6 months\" or \"+180 days\". Example: \"today\" to \"in 6 months\" lists contracts up for renewal in the next six months. Leave empty for no upper bound.",
"default": ""
},
"minLots": {
"title": "Minimum number of lots",
"minimum": 0,
"maximum": 99999,
"type": "integer",
"description": "Keep only condominiums with at least this many lots in total (flats, shops, parking spaces...). 0 = no minimum.",
"default": 0
},
"maxLots": {
"title": "Maximum number of lots",
"minimum": 0,
"maximum": 99999,
"type": "integer",
"description": "Keep only condominiums with at most this many lots in total. 0 = no maximum.",
"default": 0
},
"builtBefore": {
"title": "Built before",
"enum": [
"any",
"1949",
"1975",
"2001"
],
"type": "string",
"description": "Keep only buildings whose construction period ends before this year (buildings with an unknown period are left out). Before 1975 is the usual target for energy renovation, façade and lift work.",
"default": "any"
},
"anahAidedOnly": {
"title": "Only condominiums aided by Anah",
"type": "boolean",
"description": "Keep only condominiums that received a grant from Anah, the national housing agency (MaPrimeRénov' Copropriété and similar schemes, since 2014).",
"default": false
},
"priorityNeighbourhoodOnly": {
"title": "Only priority neighbourhoods",
"type": "boolean",
"description": "Keep only condominiums located in a priority urban neighbourhood (quartier prioritaire de la politique de la ville, 2024 boundaries).",
"default": false
},
"sortBy": {
"title": "Sort by",
"enum": [
"sourceOrder",
"mandateEndDate",
"totalLotsDesc"
],
"type": "string",
"description": "Order of the results. Mandate end date puts the contracts that end first at the top.",
"default": "sourceOrder"
},
"maxResults": {
"title": "Maximum number of results",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Safety cap on the number of condominiums returned. The run stops once it is reached, so you never pay for more than this.",
"default": 100
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}