Woningfoto's API

get

This endpoint offers available, if any, images for a residential object. The response includes an array of image URLs which are available for download for 24 hours.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

postalCodestringRequired

Postal code

Example: 1251NJ

houseNumberintegerRequired

House number

Example: 22

houseLetterstringOptional

House letter

houseNumberExtstringOptional

House number extension

Responses

200

HouseImagesResponse

application/json

idstring · nullableOptionalExample: string

statusstringRequiredExample: success

400

HTTP 400

application/json

401

HTTP 401

application/json

403

HTTP 403

application/json

404

HTTP 404

application/json

500

HTTP 500

application/json

get/house-images

GET /v1/house-images?postalCode=1251NJ&houseNumber=22 HTTP/1.1
Host: api.matrixian.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "string",
  "params": {
    "postalCode": "1251NJ",
    "houseNumber": 22,
    "houseLetter": null,
    "houseNumberExt": null
  },
  "data": {
    "address": {
      "postalCode": "1251NJ",
      "houseNumber": 22,
      "houseLetter": null,
      "houseNumberExt": null
    },
    "imagesDate": "2026-05-27",
    "images": [
      "https://images.matrixiangroup.com/187/536/548_1440.jpg",
      "https://images.matrixiangroup.com/187/536/549_1440.jpg"
    ]
  },
  "error": {},
  "meta": {},
  "status": "success"
}

get

This endpoint offers a single image with a front view on a residential object. The response includes an image URL which is available for download for 24 hours.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

bagNumIdsstring[]RequiredExample: [417200000001419]

Responses

200

FrontViewImageResponse

application/json

idstring · nullableOptionalExample: string

statusstringRequiredExample: success

400

HTTP 400

application/json

401

HTTP 401

application/json

403

HTTP 403

application/json

404

HTTP 404

application/json

500

HTTP 500

application/json

get/get_front_view

GET /v1/get_front_view?bagNumIds=417200000001419 HTTP/1.1
Host: api.matrixian.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "string",
  "params": {
    "bagNumIds": 417200000001419
  },
  "data": {
    "items": [
      {
        "imageUrl": "text",
        "numberId": "text",
        "source": "text",
        "timestamp": 1
      }
    ]
  },
  "error": {},
  "meta": {},
  "status": "success"
}