{ "info": { "name": "Rentix CRM API", "description": "Complete API collection for Rentix CRM integration.\n\nAutomate listing publication, agent synchronization, and media management.\n\n**Getting started:**\n- Go to the `Variables` tab\n- Set your API key in the `apiKey` variable\n- (Optional) For production, change `baseUrl` to `https://crm.rentix.md/api`\n\nDocumentation: https://crm.rentix.md\n\n## Types & Enums\n\n### Announcement\n- **announcementType**: rent, sale\n- **announcementStatus**: draft, active, pending_active, publish_failed, expired, hidden, removed, completed, blocked\n- **announcementCurrency**: EUR, USD, MDL\n- **announcementBargain**: no, yes\n\n### Rent-specific\n- **announcementPayPeriod**: monthly, daily, hourly, yearly\n- **announcementPrepayment**: first-and-last-month, no-prepayment, months-3, months-6, custom-amount\n- **announcementRentDeposit**: months-1, months-3, custom-amount\n\n### Property Types\n- **propertyType**: residential, commercial, parking\n- **propertySecondaryType**:\n - rent/residential: apartment, house, room, other\n - rent/commercial: office, trade, warehouse, free-purpose, production, business, commercial-land, legal-address, other\n - rent/parking: underground-parking, open-parking, garage, covered-parking, other\n - sale/residential: apartment, house, room, residential-land, other\n - sale/commercial: office, trade, warehouse, free-purpose, production, business, commercial-land, legal-address, other\n - sale/parking: underground-parking, open-parking, garage, covered-parking, other\n\n### Property Fields\n- **propertyQuantitySize**: apartment-studio, custom-value\n- **propertyVisualState**: classic-renovation, euro-renovation, design-renovation, requires-renovation, white-finish, rough-finish\n- **propertyHousingMarket**: secondary, new-build\n- **propertyBuildingMaterial**: brick, mixed, cotilet, monolithic, concrete, block, wood, panel, aerated-concrete\n- **propertyLayout**: 102, 135, 143, brezhnevka, varnitskaia, gostinka, custom, small-family, moldovan-series, ground-level, rubashka, stalinka, khrushchyovka, cheska\n- **propertyParkingSpace**: underground, open, garage, covered\n\n### Attributes (propertyAttributes)\n- **Rules**: animals-allowed, can-smoke, kids-allowed, parties-allowed\n- **Amenities**: autonomous-heating, heated-floors, panoramic-windows, conditioner, tumble-dryer, dishwasher, wifi, open-plan-kitchen, balcony, terrace, work-space, kitchen, toilet, walk-in-shower, bathtub, bidet, tv, oven, pool, jacuzzi, gas, water, sewerage, video-surveillance, security, intercom, fireplace, sauna, garden, elevator, gym, playground, bbq-area, furnished", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "version": "1.0.0" }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://crm.staging.rentix.md/api", "type": "string" }, { "key": "apiKey", "value": "your-api-key-here", "type": "string" } ], "item": [ { "name": "Agency", "description": "Retrieve agency information and usage limits.", "item": [ { "name": "Get Agency Info", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/agency", "host": [ "{{baseUrl}}" ], "path": [ "v1", "agency" ] }, "description": "Returns agency name, ID, and current usage limits." }, "response": [] } ] }, { "name": "Listings", "description": "Create, update, retrieve, and manage real estate listings. Supports upsert pattern, bulk operations, and external ID linking.", "item": [ { "name": "Create or Update Listing", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings" ] }, "description": "Upsert a listing. If externalId is new — creates, if it exists — updates. Send only changed fields for updates.", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"apt-001\",\n \"announcementStatus\": \"active\",\n \"announcementType\": \"rent\",\n \"propertyType\": \"residential\",\n \"propertySecondaryType\": \"apartment\",\n \"announcementValue\": 500,\n \"announcementCurrency\": \"EUR\",\n \"announcementPayPeriod\": \"monthly\",\n \"propertyArea\": 65,\n \"propertyFloorNumber\": 3,\n \"propertyFloorsTotal\": 9,\n \"propertyQuantitySize\": \"custom-value\",\n \"propertyQuantitySizeValue\": 3,\n \"propertyHousingMarket\": \"new-build\",\n \"propertyVisualState\": \"euro-renovation\",\n \"propertyAddress\": \"Chișinău, str. Columna 81/1\",\n \"announcementDescription\": \"Cozy 3-room apartment with heated floors and autonomous heating.\",\n \"files\": [\n {\n \"url\": \"https://placehold.co/1920x1080/jpg?text=Living+Room\",\n \"externalFileId\": \"apt-001-photo-1\"\n },\n {\n \"url\": \"https://placehold.co/1920x1080/jpg?text=Bedroom\",\n \"externalFileId\": \"apt-001-photo-2\"\n },\n {\n \"url\": \"https://placehold.co/1920x1080/jpg?text=Kitchen\",\n \"externalFileId\": \"apt-001-photo-3\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Validate Listing", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings/validate", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings", "validate" ] }, "description": "Validate listing data without creating. Useful for CRM form validation.", "body": { "mode": "raw", "raw": "{\n \"announcementType\": \"rent\",\n \"propertyType\": \"residential\",\n \"propertySecondaryType\": \"apartment\",\n \"announcementValue\": 500,\n \"announcementCurrency\": \"EUR\",\n \"announcementDescription\": \"Cozy 3-room apartment with heated floors and autonomous heating.\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Bulk Operations", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings/bulk", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings", "bulk" ] }, "description": "Process up to 100 listing operations in a single request. Supports upsert, link, unlink, delete, and validate.", "body": { "mode": "raw", "raw": "{\n \"operations\": [\n {\n \"op\": \"upsert\",\n \"externalId\": \"apt-001\",\n \"announcementType\": \"rent\",\n \"propertyType\": \"residential\",\n \"propertySecondaryType\": \"apartment\",\n \"announcementValue\": 500,\n \"announcementCurrency\": \"EUR\"\n },\n {\n \"op\": \"link\",\n \"id\": 42,\n \"externalId\": \"apt-001\"\n },\n {\n \"op\": \"delete\",\n \"externalId\": \"apt-002\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "List Listings", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings" ], "query": [ { "key": "status", "value": "active", "description": "Filter by status (draft, active, hidden, completed, pending_active)", "disabled": true }, { "key": "userId", "value": "1", "description": "Filter by Rentix user ID", "disabled": true }, { "key": "externalUserId", "value": "agent-001", "description": "Filter by external user ID", "disabled": true }, { "key": "syncedAfter", "value": "2025-01-01T00:00:00Z", "description": "Only listings synced after this date", "disabled": true }, { "key": "page", "value": "1", "description": "Page number (default 1)", "disabled": true }, { "key": "limit", "value": "20", "description": "Items per page, max 100 (default 20)", "disabled": true } ] }, "description": "Get a paginated list of listings with optional filters." }, "response": [] }, { "name": "Get Listing by ID", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings", ":id" ] }, "description": "Retrieve a listing by its Rentix internal ID." }, "response": [] }, { "name": "Get Listing by External ID", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings/external/:externalId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings", "external", ":externalId" ] }, "description": "Retrieve a listing by your CRM external ID." }, "response": [] }, { "name": "Link External ID", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings/:id/link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings", ":id", "link" ] }, "description": "Link an external CRM ID to an existing Rentix listing.", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"apt-001\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Unlink External ID", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings/:id/link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings", ":id", "link" ] }, "description": "Remove the external ID mapping from a listing." }, "response": [] } ] }, { "name": "Users", "description": "Create, update, and manage agent profiles. Supports upsert pattern and external ID linking.", "item": [ { "name": "Create or Update User", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users" ] }, "description": "Upsert an agent profile. Identify by externalId or id.", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"agent-001\",\n \"name\": \"Ivan Petrov\",\n \"description\": \"Experienced real estate agent. Working with residential and commercial properties.\",\n \"instagram\": \"https://instagram.com/ivan.petrov\",\n \"settings\": {\n \"contact_phone\": true,\n \"contact_whatsapp\": true,\n \"contact_telegram\": true\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Bulk Operations", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users/bulk", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users", "bulk" ] }, "description": "Process up to 100 user operations in a single request.", "body": { "mode": "raw", "raw": "{\n \"operations\": [\n {\n \"op\": \"upsert\",\n \"externalId\": \"agent-001\",\n \"name\": \"Ivan Petrov\",\n \"settings\": {\n \"contact_whatsapp\": true\n }\n },\n {\n \"op\": \"upsert\",\n \"externalId\": \"agent-002\",\n \"name\": \"Maria Ivanova\",\n \"settings\": {\n \"contact_telegram\": true\n }\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "List Users", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users" ] }, "description": "List all agents in your agency." }, "response": [] }, { "name": "Get User by ID", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users", ":id" ] }, "description": "Retrieve an agent by Rentix internal ID." }, "response": [] }, { "name": "Get User by External ID", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users/external/:externalId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users", "external", ":externalId" ] }, "description": "Retrieve an agent by your CRM external ID." }, "response": [] }, { "name": "Link External ID", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users/:id/link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users", ":id", "link" ] }, "description": "Link an external CRM ID to an existing Rentix user.", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"agent-001\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Unlink External ID", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users/:id/link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users", ":id", "link" ] }, "description": "Remove the external ID mapping from a user." }, "response": [] } ] }, { "name": "Media", "description": "Upload, manage, and link media files. Supports URL import, signed upload URLs, and bulk operations.", "item": [ { "name": "Request Upload URL", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/request-upload-url", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", "request-upload-url" ] }, "description": "Get signed URLs for direct file upload. URLs are valid for 30 minutes.", "body": { "mode": "raw", "raw": "{\n \"files\": [\n {\n \"fileName\": \"living-room.jpg\",\n \"size\": 245000,\n \"contentType\": \"image/jpeg\",\n \"externalId\": \"apt-001-photo-1\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Confirm Upload", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/confirm-upload", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", "confirm-upload" ] }, "description": "Confirm that a file has been uploaded to the signed URL.", "body": { "mode": "raw", "raw": "{\n \"generatedFileName\": \"abc123_living-room.jpg\",\n \"uuid\": \"abc123\",\n \"externalId\": \"apt-001-photo-1\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Upload from URL", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/upload-from-url", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", "upload-from-url" ] }, "description": "Import a media file from a public URL. The system downloads and optimizes it automatically.", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://placehold.co/1920x1080/jpg?text=Living+Room\",\n \"externalId\": \"apt-001-photo-1\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Bulk Operations", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/bulk", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", "bulk" ] }, "description": "Process up to 100 media operations. Supports upload-from-url, confirm-upload, link, unlink, and delete.", "body": { "mode": "raw", "raw": "{\n \"operations\": [\n {\n \"op\": \"upload-from-url\",\n \"url\": \"https://placehold.co/1920x1080/jpg?text=Living+Room\",\n \"externalId\": \"apt-001-photo-1\"\n },\n {\n \"op\": \"upload-from-url\",\n \"url\": \"https://placehold.co/1920x1080/jpg?text=Bedroom\",\n \"externalId\": \"apt-001-photo-2\"\n },\n {\n \"op\": \"link\",\n \"mediaId\": 123,\n \"externalId\": \"old-photo-linked\"\n },\n {\n \"op\": \"delete\",\n \"externalId\": \"old-photo-to-remove\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Get Media", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/:mediaId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", ":mediaId" ] }, "description": "Retrieve a media file by its Rentix internal ID." }, "response": [] }, { "name": "Get Media by External ID", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/external/:externalId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", "external", ":externalId" ] }, "description": "Retrieve a media file by your CRM external ID." }, "response": [] }, { "name": "Delete Media", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/:mediaId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", ":mediaId" ] }, "description": "Delete a media file by its Rentix internal ID." }, "response": [] }, { "name": "Delete Media by External ID", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/external/:externalId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", "external", ":externalId" ] }, "description": "Delete a media file by your CRM external ID." }, "response": [] }, { "name": "Link External ID", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/:mediaId/link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", ":mediaId", "link" ] }, "description": "Link an external CRM ID to an existing media file.", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"apt-001-photo-1\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Unlink External ID", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/:mediaId/link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", ":mediaId", "link" ] }, "description": "Remove the external ID mapping from a media file." }, "response": [] } ] }, { "name": "Reference", "description": "Access reference data: property field schemas, locations, and currencies.", "item": [ { "name": "Get Base Schema", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/reference/schema/base", "host": [ "{{baseUrl}}" ], "path": [ "v1", "reference", "schema", "base" ] }, "description": "Get the base field schema. Returns listing types, property categories, form fields, and constraints." }, "response": [] }, { "name": "Get Contextual Schema", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/reference/schema", "host": [ "{{baseUrl}}" ], "path": [ "v1", "reference", "schema" ], "query": [ { "key": "announcementType", "value": "rent", "description": "rent or sale" }, { "key": "propertyType", "value": "residential", "description": "residential, commercial, or parking" }, { "key": "propertySecondaryType", "value": "apartment", "description": "Specific property subtype" } ] }, "description": "Get the contextual field schema for a specific property type combination. All 3 query parameters are required." }, "response": [] }, { "name": "Get Currencies", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/reference/currencies", "host": [ "{{baseUrl}}" ], "path": [ "v1", "reference", "currencies" ] }, "description": "Get supported currencies and current exchange rates." }, "response": [] } ] }, { "name": "Job", "description": "Track the status of asynchronous background jobs (photo processing, publishing, etc.).", "item": [ { "name": "Get Job Status", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/job/status", "host": [ "{{baseUrl}}" ], "path": [ "v1", "job", "status" ], "query": [ { "key": "id", "value": "789", "description": "Job ID returned from listing/media operations" } ] }, "description": "Check the status of an asynchronous job by its ID." }, "response": [] } ] } ] }